Prerequisites

Docker + Docker Compose v2

All NestFleet services run in Docker containers. Compose v2 is required (the docker compose sub-command, not the legacy docker-compose).

Docker Engine 24+ · Docker Compose 2.20+

LLM API key

NestFleet requires access to a large language model for triage, auto-reply, and change request drafting. Supported providers: Anthropic (recommended), OpenAI, Google Gemini, or a locally-running Ollama instance. The API key is encrypted at rest using AES-256-GCM.

PostgreSQL 16

NestFleet uses PostgreSQL with the pgcrypto extension (installed automatically). You can use the bundled PostgreSQL container in docker-compose.prod.yml, or bring your own managed database (Hetzner Managed DB, RDS, etc.).

A public domain + open ports 80 and 443

Required for production TLS. Caddy provisions a Let's Encrypt certificate automatically when NESTFLEET_DOMAIN is set and the domain resolves to your server. Ports 80 (ACME challenge) and 443 (HTTPS) must be reachable from the internet.

GitHub App credentials

Required only if you want NestFleet to draft pull requests and ingest GitHub issues. See GitHub App Setup.

SMTP / email provider

For inbound email ingestion and outbound auto-replies. Supported: Postmark (POSTMARK_API_KEY), Resend (RESEND_API_KEY), or any SMTP relay (SMTP_HOST /SMTP_USER /SMTP_PASS).

Telegram Bot token

For Telegram channel ingestion. Create a bot via @BotFather and set TELEGRAM_BOT_TOKEN.