Skip to content
Docs
Enterprise

To get started, you’ll need a machine that meets the following requirements and has administrator privileges.

  1. Go to console.cascadia.to/signup and create an account with your work email.

  2. Open the confirmation link in your email, and sign in.

  3. Name your organization and choose its URL name. Your fleet’s certificate authority lives at ca.cascadia.to/o/<url-name>.

If a colleague already set up your organization, ask them to invite you from Members instead of creating a new one.

  1. In the console, open Devices → Add device. When it asks who will run the installer, choose I will.

  2. Select Create installer, then Download installer for your operating system.

  3. Run the installer on the PC and accept the prompts. On Windows these are Keep, Run and Yes; on Ubuntu, Install and your password.

  4. Wait for the install to finish (this typically takes 2 to 10 minutes). It sets up the node software and a small model, then enrolls the PC in your fleet.

The device appears on the console’s Devices page as soon as it enrolls.

If the install stops, see Installing a device.

  1. In the console, open Settings → API tokens.

  2. Enter a label, such as quickstart, choose an expiry and select Create token.

  3. Copy the token. The console shows it only once.

On the device you just added, list the models it can reach, then send a chat request with one of their IDs. Replace <TOKEN> with your token and <MODEL_ID> with an id from the list.

In PowerShell:

Terminal window
$headers = @{ Authorization = "Bearer <TOKEN>" }
Invoke-RestMethod http://127.0.0.1:9100/v1/models -Headers $headers
$body = '{"model":"<MODEL_ID>","messages":[{"role":"user","content":"Hello!"}]}'
Invoke-RestMethod http://127.0.0.1:9100/v1/chat/completions -Method Post `
-Headers $headers -ContentType "application/json" -Body $body

The gateway only accepts requests from the device it runs on. Your fleet then routes each request to whichever devices serve the model you asked for.