Skip to main content

​
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)

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.