Skip to main content

​
Overview

Registering your Station with CloudShip enables:
  • Remote agent execution
  • Centralized monitoring
  • Bundle distribution
  • OAuth authentication for MCP

​
Getting a Registration Key

1

Log in to CloudShip

Go to app.cloudshipai.com and sign in
2

Navigate to Stations

Click Stations in the sidebar
3

Create Registration Key

Click New Registration Key and give it a name
4

Copy the Key

Copy the generated key (it won’t be shown again)

​
Registering Your Station

​
During Init

stn init --provider openai \
  --cloudship-key "your-registration-key" \
  --cloudship-endpoint "lighthouse.cloudship.ai:443" \
  --yes

​
Existing Station

Edit ~/.config/station/config.yaml: 
local_mode: false
cloudship:
  enabled: true
  registration_key: "your-registration-key"
  endpoint: lighthouse.cloudship.ai:443
Then restart Station: 
stn down && stn up
# or
pkill stn && stn serve

​
Via Environment Variables

export STN_CLOUDSHIP_KEY="your-registration-key"
export STN_CLOUDSHIP_ENDPOINT="lighthouse.cloudship.ai:443"
export STATION_LOCAL_MODE="false"
stn serve

​
Verification

After registration, verify the connection: 
stn status
You should see: 
Station Status
├─ Mode: CloudShip Connected
├─ Registration: Active
├─ Lighthouse: lighthouse.cloudship.ai:443
└─ Station ID: abc123
In the CloudShip dashboard, your Station will appear in the Stations list.

​
What Happens After Registration

Once registered, your Station:
  1. Opens a management channel to Lighthouse
  2. Reports status periodically (health, agents, tools)
  3. Receives commands for remote execution
  4. Sends telemetry if enabled

​
Security

​
Connection Security

  • All communication uses TLS encryption
  • Registration keys are one-time use
  • Station authenticates with Lighthouse on each connection

​
Data Privacy

  • Agent prompts stay on your Station
  • Only execution results are sent to CloudShip (if requested)
  • Telemetry is opt-in

​
Revoking Access

To disconnect a Station:
  1. In CloudShip dashboard, go to Stations
  2. Click the Station you want to remove
  3. Click Revoke Registration
Or locally: 
# config.yaml
local_mode: true
cloudship:
  enabled: false

​
Local Development with Lighthouse

For testing CloudShip integration locally: 
# Start local Lighthouse (in cloudshipai repo)
cd cloudshipai/lighthouse
go run cmd/main.go

# Configure Station to use local Lighthouse
stn init --provider openai \
  --cloudship-key "test-key" \
  --cloudship-endpoint "localhost:50051" \
  --yes
Local Lighthouse requires additional setup. See Lighthouse documentation.

​
Troubleshooting

​
Connection Failed

Error: failed to connect to Lighthouse
Check:
  • Internet connectivity
  • Registration key validity
  • Endpoint URL (should include port)

​
Registration Rejected

Error: registration key invalid or expired
Generate a new registration key in the CloudShip dashboard.

​
Already Registered

Error: station already registered
Each registration key can only be used once. Either:
  • Use a new registration key
  • Delete the existing Station in CloudShip dashboard