Station Registration

​

Overview

• Remote agent execution
• Centralized monitoring
• Bundle distribution
• OAuth authentication for MCP

​

Getting a Registration Key

​

Registering Your Station

​

During Init

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

​

Existing Station

local_mode: false
cloudship:
  enabled: true
  registration_key: "your-registration-key"
  endpoint: lighthouse.cloudship.ai:443

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

stn status

Station Status
├─ Mode: CloudShip Connected
├─ Registration: Active
├─ Lighthouse: lighthouse.cloudship.ai:443
└─ Station ID: abc123

​

What Happens After Registration

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

1. In CloudShip dashboard, go to Stations
2. Click the Station you want to remove
3. Click Revoke Registration

# config.yaml
local_mode: true
cloudship:
  enabled: false

​

Local Development with Lighthouse

# 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

​

Troubleshooting

​

Connection Failed

Error: failed to connect to Lighthouse

• Internet connectivity
• Registration key validity
• Endpoint URL (should include port)

​

Registration Rejected

Error: registration key invalid or expired

​

Already Registered

Error: station already registered

• Use a new registration key
• Delete the existing Station in CloudShip dashboard