Self-Hosted Deployment

Deploy BugSpotter on your own infrastructure with Docker Compose. Full feature parity with SaaS — including AI intelligence on self-hosted Ollama.

Prerequisites

Docker 20.10+ with Docker Compose v2
Linux server (Ubuntu 22.04+ recommended)
Hardware: 2 CPU / 4 GB RAM minimum (without AI), 4 CPU / 16 GB RAM (with AI/Ollama)
Disk: 20 GB free space

Quick Start

git clone https://github.com/apex-bridge/bugspotter-deploy
cd bugspotter-deploy
bash install.sh

The install script will:

Check prerequisites (Docker, Compose, openssl)
Generate secure secrets (JWT, encryption keys, passwords)
Pull Docker images from GitHub Container Registry
Start all services
Print access URLs when ready

Services

Service	Description	Port
Admin Panel	Web UI	80
API	Backend REST API	3000
Worker	Background job processor	(internal)
PostgreSQL	Database	(internal)
Redis	Job queues & cache	(internal)
MinIO	S3-compatible storage	(internal)

Enable AI Features

# Start with AI services (Ollama + pgvector)
docker compose --profile intelligence up -d

# First start downloads the LLM model (~4.7 GB)
# Then enable in .env:
#   INTELLIGENCE_ENABLED=true
docker compose up -d

AI features require 4 CPU / 16 GB RAM minimum.

Configuration

Edit .env to customize your deployment. Key settings:

Variable	Description	Default
`ADMIN_PORT`	Admin panel port	80
`API_PORT`	API port	3000
`CORS_ORIGINS`	Allowed origins	http://localhost
`FRONTEND_URL`	Admin panel URL	http://localhost
`SMTP_HOST`	Email server	(disabled)

Upgrading

docker compose pull
docker compose up -d

Backup

# Database
docker compose exec postgres pg_dump -U bugspotter bugspotter > backup.sql

Security

Only API and Admin ports are exposed. Database, Redis, and MinIO communicate on the internal Docker network.
Place a reverse proxy (nginx, Caddy, Traefik) in front for TLS termination.
Software is free under FSL-1.1 license. Becomes Apache 2.0 after 2 years.

Next: API Reference →