API server
Install
Docker
The repository's docker-compose.yml builds the image and runs it on port 4000, with the database in a reseam-data volume:
ADMIN_TOKEN=$(openssl rand -hex 32) docker compose up -d --build
curl http://localhost:4000/v1/health
Keep the ADMIN_TOKEN value: you need it to post announcements. Set the other configuration in the compose file or an .env file.
The compose file also starts the translation engine, which downloads its models on first start.
Bun
bun install
bun run dev # restarts on changes
bun run start # production
The database is created at ./data/reseam.db, and its migrations run on startup.
Health
GET /v1/health returns { "ok": true, "version": "..." }. It shows the server is up; it doesn't check the database or the upstream files.
Next: Configuration.