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

# Install the Fjall CLI

> Install the Fjall CLI globally or per-project with npm, then verify it before deploying to AWS.

<AccordionGroup>
  <Accordion title="Pre-Requisites">
    Install the following:

    * [Node.js 22+](https://nodejs.org/) (includes npm)
    * [npm CLI](https://docs.npmjs.com/cli/v11/configuring-npm/install)

    Use a configured terminal:

    * The integrated terminal in [Visual Studio Code](https://code.visualstudio.com/)
    * [iTerm2](https://iterm2.com/) on macOS
  </Accordion>
</AccordionGroup>

***

## Installation Options

### Global Installation (Recommended)

Install Fjall globally to use it across all your projects:

```bash theme={null}
npm install -g fjall
```

After installation, you can use `fjall` commands from anywhere:

```bash theme={null}
fjall --version
fjall create app
```

### Project Installation

Install Fjall as a project dependency:

1. **Initialise your project** (if needed):

   ```bash theme={null}
   npm init -y
   ```

2. **Install Fjall CLI**:

   ```bash theme={null}
   npm install --save-dev fjall
   ```

3. **Add to package.json scripts** (optional):

   ```json theme={null}
   {
     "scripts": {
       "fjall": "fjall"
     }
   }
   ```

4. **Run commands**:
   ```bash theme={null}
   npx fjall create app
   # or if you added the script:
   npm run fjall create app
   ```

***

## Verify Installation

Confirm that Fjall was installed correctly:

```bash theme={null}
# For global installation:
fjall --version

# For project installation:
npx fjall --version
```

You should see the version number printed to the terminal.

***

## Next Steps

Choose your path:

<CardGroup cols={2}>
  <Card title="Create Application" icon="sparkles" href="/deployment/create-application">
    Deploy a standalone app. Best for single accounts, prototypes, or quick starts.
  </Card>

  <Card title="Deploy Organisation" icon="city" href="/deployment/deploy-organisation">
    Set up a multi-account AWS environment with OIDC federation, SSO, and account separation.
  </Card>
</CardGroup>

<Note>
  Not sure which to choose? Start with deploying an application. You can add organisation structure later.
</Note>