Skip to Content
Self-HostingAPI-only mode

API-only mode

Run Greenlight without the Admin UI when agents and scripts are your only clients.

Compose

Remove (or comment out) the greenlight-ui service from docker-compose.self-host.yml.

The gateway on port 8100 is unchanged:

  • POST /v1/channels/new
  • POST /v1/prompts/new
  • GET /v1/channels
  • Platform webhooks under /webhooks/...

Auth

For production, set:

USE_AUTH=true
GREENLIGHT_API_KEY=replace-with-a-strong-random-api-key
CALLBACK_SIGNING_SECRET=replace-with-a-strong-random-string
WEBHOOK_SECRET=replace-with-a-strong-random-string
PUBLIC_WEBHOOK_URL=https://api.example.com

All agent routes then require X-API-Key.

Managing channels without the UI

curl -X POST https://api.example.com/v1/channels/new \
  -H "X-API-Key: $GREENLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }'
 
curl https://api.example.com/v1/channels \
  -H "X-API-Key: $GREENLIGHT_API_KEY"

See Agent API for the full surface.

ConfigurationAgent integration