ActionCable WebSocket server for Mothership. Runs as a bay using the docking protocol.

OrbitCast handles ActionCable WebSocket connections, multiplexed through Mothership's docking protocol. Multiple client connections share a single Unix socket.

Clients (WS) → Mothership → Unix Socket → OrbitCast
 ↓
 RPC
 (anycable-rails)
 ↓
 Pub/Sub
 (PostgreSQL or Memory)

# Production (multi-node coordination via PostgreSQL)
cargo install orbitcast
# Or explicitly:
# cargo install orbitcast --features postgres
# Development (single-node, in-memory)
cargo install orbitcast --no-default-features --features memory

Exactly one backend is required. Use --no-default-features to disable the default PostgreSQL backend when using memory.

Add to your ship-manifest.toml:

[[bays.websocket]]
name = "orbitcast"
command = "orbitcast"
routes = [{ bind = "ws", pattern = "/cable" }]
config = { database_url = "postgres://localhost/myapp" }

Set automatically by Mothership:

Uses LISTEN/NOTIFY for cross-node broadcasting. Required for multi-instance deployments.

OrbitCast honors the sslmode query param in database_url:

• disable: non-TLS only
• allow: try non-TLS, then TLS
• prefer (default): try TLS, then non-TLS
• require: TLS only
• verify-ca, verify-full: TLS only (certificate verification uses system roots)

Uses tokio::sync::broadcast. Single process only. Good for development.

Limitations:

• No cross-node coordination
• No persistence
• Lagging receivers lose messages

OrbitCast requires PostgreSQL for multi-node pub/sub. If you need Redis or NATS backends, use AnyCable-Go directly as your WebSocket server instead of OrbitCast.

orbitcast --help
orbitcast --log-level debug

OrbitCast speaks the AnyCable RPC protocol. Run the anycable-rails RPC server and point OrbitCast to it via rpc_host.

Protocol compatibility: AnyCable RPC protocol 1.6.2+.

Example ship config:

[[bays.websocket]]
name = "orbitcast"
command = "orbitcast"
routes = [{ bind = "ws", pattern = "/cable" }]
config = { rpc_host = "127.0.0.1:50051", database_url = "postgres://localhost/myapp" }

MIT