> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation & Setup

> Install the Para CLI and authenticate with your developer account

export const Card = ({imgUrl, title, description, href, horizontal = false, newTab = false}) => {
  const [isHovered, setIsHovered] = useState(false);
  const handleClick = e => {
    e.preventDefault();
    if (newTab) {
      window.open(href, '_blank', 'noopener,noreferrer');
    } else {
      window.location.href = href;
    }
  };
  return <div className={`not-prose relative my-2 p-[1px] rounded-xl transition-all duration-300 ${isHovered ? 'bg-gradient-to-r from-[#FF4E00] to-[#874AE3]' : 'bg-gray-200'}`} onMouseEnter={() => setIsHovered(true)} onMouseLeave={() => setIsHovered(false)}>
      <a href={href} onClick={handleClick} className={`not-prose flex ${horizontal ? 'flex-row' : 'flex-col'} font-normal h-full bg-white overflow-hidden w-full cursor-pointer rounded-[11px] no-underline`}>
        {imgUrl && <div className={`relative overflow-hidden flex-shrink-0 ${horizontal ? 'w-[30%] rounded-l-[11px]' : 'w-full'}`} onClick={e => e.stopPropagation()}>
            <img src={imgUrl} alt={title} className="w-full h-full object-cover pointer-events-none select-none" draggable="false" />
            <div className="absolute inset-0 pointer-events-none" />
          </div>}
        <div className={`flex-grow px-6 py-5 ${horizontal ? 'w-[70%]' : 'w-full'} flex flex-col ${horizontal && imgUrl ? 'justify-center' : 'justify-start'}`}>
          {title && <h2 className="font-semibold text-base text-gray-800 m-0">{title}</h2>}
          {description && <div className={`font-normal text-gray-500 re leading-6 ${horizontal || !imgUrl ? 'mt-0' : 'mt-1'}`}>
              <p className="m-0 text-xs">{description}</p>
            </div>}
        </div>
      </a>
    </div>;
};

## Install

<CodeGroup>
  ```bash npm theme={null}
  npm install -g @getpara/cli
  ```

  ```bash yarn theme={null}
  yarn global add @getpara/cli
  ```

  ```bash pnpm theme={null}
  pnpm add -g @getpara/cli
  ```
</CodeGroup>

Verify the installation:

```bash theme={null}
para --version
```

<Tip>You can also run the CLI without installing globally using `npx @getpara/cli@latest`, `yarn dlx @getpara/cli@latest`, or `pnpm dlx @getpara/cli@latest`.</Tip>

## Authenticate

Log in with your Para developer account:

```bash theme={null}
para login
```

This starts a Developer Portal sign-in flow and prints the browser instructions in your terminal. Once you approve, the CLI stores your session locally at `~/.config/para/credentials.json`.

After login, the CLI automatically selects your first organization and project. Use `para whoami` to verify:

```bash theme={null}
para whoami
```

## Configuration

The CLI resolves configuration from multiple sources in this order (highest priority first):

1. **CLI flags** (`-e`, `--org`, `--project`)
2. **Environment variables** (`PARA_ENVIRONMENT`, `PARA_ORG_ID`, `PARA_PROJECT_ID`)
3. **Project config** (`.pararc` in the current directory)
4. **Global config** (`~/.config/para/config.json`)
5. **Defaults** (key environment: `beta`)

### Project-Level Config

Pin your organization, project, and environment to a directory with `para init`:

```bash theme={null}
para init
```

This creates a `.pararc` file in the current directory. Team members who clone the repo get the same defaults without manual setup. See the [config commands](/v3/cli/commands#configuration) page for details.

Use `para init --yes` when you already have the right org, project, and key environment selected and want to skip the environment prompt.

### Global Config

Set defaults that apply across all projects:

```bash theme={null}
para config set defaultEnvironment beta
para config set defaultOrganizationId your-org-id
para config set defaultProjectId your-project-id
```

## Key Environment

Each Para project has two API key tiers: **beta** (for development and testing) and **prod** (for production). The `-e` flag selects which tier to operate on:

```bash theme={null}
para keys list -e beta    # List beta keys (default)
para keys list -e prod    # List prod keys
```

| Key Environment | Description                  |
| --------------- | ---------------------------- |
| `beta`          | Development and testing keys |
| `prod`          | Production keys              |

The default is `beta`. Most commands auto-resolve the correct API key from your active project and key environment, so you rarely need to pass a key ID explicitly.

## Global Flags

These flags work with every command:

| Flag                      | Description                                         |
| ------------------------- | --------------------------------------------------- |
| `-e, --environment <env>` | Key environment: `beta` or `prod` (default: `beta`) |
| `--json`                  | Output as JSON for scripting and CI/CD              |
| `-q, --quiet`             | Suppress non-essential output                       |
| `--org <id>`              | Override the active organization                    |
| `--project <id>`          | Override the active project                         |

<Note>
  The CLI does not use a global no-input flag. Commands that can run non-interactively expose their own required flags, such as `para init --yes`, `para keys rotate --yes`, or `para create my-app -t nextjs --networks evm`.
</Note>

## Next Steps

<CardGroup cols={2}>
  <Card title="Authentication" imgUrl="/images/v3/general-server.png" href="/v3/cli/commands#authentication" description="Login, logout, and session management" />

  <Card title="API Keys" imgUrl="/images/v3/general-examples.png" href="/v3/cli/commands#api-keys" description="Create and configure API keys" />
</CardGroup>