Installation

AgenticKode runs entirely in Docker. A single docker compose up -d brings up the backend, frontend, worker, and database.

Prerequisites

Docker >= 24.0 and Docker Compose v2
A git provider account (GitHub, GitLab, Gitea, or Bitbucket)
At least one AI provider (Claude CLI, Codex CLI, OpenCode, or a local Ollama server)
A workspace server accessible via SSH (can be the same machine)

git clone https://github.com/mechemsi/agentickode.git
cd agentickode

Copy the example environment file and fill in your values:

cp .env.example .env

Variable	Description
`DATABASE_URL`	PostgreSQL connection string (default provided for Docker)
`SECRET_KEY`	Application secret for session signing and encryption

Configure at least one AI provider:

Variable	Description
`ANTHROPIC_API_KEY`	API key for the Claude CLI agent
`OLLAMA_BASE_URL`	Optional — URL of your Ollama server (e.g., `http://ollama:11434`) for local models

Configure the providers you use:

Variable	Description
`GITHUB_TOKEN`	GitHub personal access token with `repo` scope
`GITLAB_TOKEN`	GitLab personal access token with `api` scope
`GITEA_TOKEN`	Gitea access token
`GITEA_BASE_URL`	Gitea instance URL (e.g., `https://gitea.example.com`)
`BITBUCKET_USERNAME`	Bitbucket username
`BITBUCKET_APP_PASSWORD`	Bitbucket app password with repository permissions

Variable	Description
`SLACK_WEBHOOK_URL`	Slack incoming webhook URL
`DISCORD_WEBHOOK_URL`	Discord webhook URL
`TELEGRAM_BOT_TOKEN`	Telegram bot token
`TELEGRAM_CHAT_ID`	Telegram chat ID for notifications

docker compose up -d

This starts:

backend — FastAPI API server on port 8000
frontend — React/Vite UI on port 5173
worker — Background worker that runs flow prompts (a single agent call per run)
db — PostgreSQL database

The database migrations run automatically on first start.

Open the UI at http://localhost:5173 and check the Settings > Health page. All services should show a green status.

You can also verify from the command line:

curl http://localhost:8000/api/health

For local development with hot-reload and debugging tools:

docker compose -f docker-compose.dev.yml up -d

The dev compose file mounts source directories and enables auto-reload for both backend and frontend.

Pull the latest changes and rebuild:

git pull
docker compose up -d --build

Database migrations apply automatically on startup.