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

# Prerequisites

### Additional requirements for Self-host

#### Node.js and npm

* **Node.js**: Version 18.0.0 or higher
* **npm**: Comes bundled with Node.js
* **Install from**: [https://nodejs.org/](https://nodejs.org/)

#### Git

* **Required**: Git must be installed and configured
* **Configure your identity**:

```bash theme={null}
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
```

#### GitHub CLI (gh)

* **Required for PR creation**: `gh` must be installed and authenticated
* **Install**: [https://cli.github.com/](https://cli.github.com/)
* **Authenticate**:

```bash theme={null}
gh auth login
gh auth setup-git
```

### Step 2: Install Cyrus (Self-host only)

For Self-host users, install the Cyrus package locally:

```bash theme={null}
npm install -g cyrus-ai
```

The onboarding wizard will verify your installation.

### Step 3: Authenticate Cyrus (Self-host only)

Run Cyrus and complete authentication with the key provided:

```bash theme={null}
cyrus auth cysk...
```

This creates a secure connection between your local Cyrus instance and the hosted infrastructure.

<Danger>
  **IMPORTANT:** You must keep the `cyrus` process running in order to complete onboarding, and to use it in Linear. If you already ran `cyrus auth`, you can restart Cyrus by running `cyrus`.
</Danger>

<Tip>
  **NOTE:** If you are having issues with the Cloudflare tunnel, confirm that your system satisifes these [Connectivity pre-checks](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/troubleshoot-tunnels/connectivity-prechecks/).
</Tip>