Prerequisites - Documentation

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/

Git

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

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/
Authenticate:

gh auth login
gh auth setup-git

Step 2: Install Cyrus (Self-host only)

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

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:

cyrus auth cysk...

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

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.

NOTE: If you are having issues with the Cloudflare tunnel, confirm that your system satisifes these Connectivity pre-checks.

Setup scripts Monitoring

⌘I

​Additional requirements for Self-host

​Node.js and npm

​Git

​GitHub CLI (gh)

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

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

Additional requirements for Self-host

Node.js and npm

Git

GitHub CLI (gh)

Step 2: Install Cyrus (Self-host only)

Step 3: Authenticate Cyrus (Self-host only)