Welcome to Stolonic

Set up your worker to start deploying agents.

API Key

Download

Connect

Your Worker API Key

This key authenticates your worker with the platform. Copy it now — it won't be shown again.

Save this key now — it will not be shown again. If you lose it, generate a new one from the API Keys page.

Download Worker

Choose your platform and download the worker package. It includes everything you need to run a deployment worker.

🐧

Linux

amd64



macOS

Apple Silicon

💻

Windows

amd64

What you get

worker-setup/

docker-compose.yml — worker service definition

config.yaml — workspace & LLM configuration template

.env.example — paste your API key here

Requirements

• Docker 20.10+ with Compose v2 (docker compose, with a space) — the worker has no Docker-free install path

• Outbound network — to your platform (WSS) and to pull images from ghcr.io

• A worker API key (agsp_…) — paste into .env (from Org Settings › Workers)

• ~2 GB RAM + a few GB disk — docker compose up runs 5 containers (worker, OTEL collector, Jaeger, Redis, nginx) plus the agents you deploy

cosign optional — verifies the signed worker image

Start Your Worker

Extract the downloaded package, paste your API key, and start the worker.

1
Extract the downloaded worker-setup package and open a terminal in that directory.
2
Create a .env file with your API key:
# .env STOLONIC_API_KEY=your-api-key
3
Start the worker:
docker compose up -d

◯

Waiting for worker connection...

Start your worker and it will appear here automatically.

Go to Dashboard

Worker not connecting, or on Windows/Mac? See the setup guide & troubleshooting.

Lost your key? Generate a new one from the API Keys page.