Raycast Offline

A local server that emulates the Raycast Backend API - designed for air-gapped environments where Raycast cannot access the internet.

Running the server

1. Generate HTTPS certificate with mkcert.

   mkcert -key-file certs/key.pem -cert-file certs/certificate.pem www.raycast.com backend.raycast.com

2. Install dependencies using:

   uv sync

3. Run the server with:

   python run.py

Setting up the machine

1. Edit hosts file - point www.raycast.com and backend.raycast.com to localhost (or your server's IP if running remotely).

   • On Windows: C:\Windows\System32\drivers\etc\hosts
   • On macOS/Linux: /etc/hosts

2. Install the root CA certificate from https://backend.raycast.com/ca in your system's trusted root store.

   • On Windows, double-click the certificate file and follow the prompts to install it. When prompted, select Place all certificates in the following store and choose Trusted Root Certification Authorities.
   • On macOS, open Keychain Access, drag the certificate into the "System" keychain, and set it to "Always Trust".
   • On Linux, copy the certificate to /usr/local/share/ca-certificates/ and run sudo update-ca-certificates.

3. Start Raycast and hit Login.

   • When Proxy error appears, click "Configure Proxy" and enable the Use System CA option, or alternatively, add the certificate manually under Additional Certificate Authority.

Enjoy using Raycast Offline!