Self-Host in 5 Minutes

TestForge runs on your own infrastructure — your data is 100% yours. Minimum requirements: Docker and 2GB RAM (PRD §5.4).

1. Docker Compose (recommended)

git clone https://github.com/mansyur007/testforge.git
cd testforge
docker compose up -d

The app is available at http://localhost:3000. The first account to register automatically becomes Admin.

2. Environment configuration

AUTH_SECRET=long-random-secret               # required — change in production
DATABASE_URL=file:/data/testforge.db          # or postgresql://... for Postgres
NEXT_PUBLIC_BASE_URL=https://testforge.company.com
SMTP_URL=smtp://user:pass@mail:587            # optional, for verification emails
GOOGLE_CLIENT_ID=...                          # optional, for Google OAuth
GITHUB_CLIENT_ID=...                          # optional, for GitHub OAuth

3. VPS / Bare metal

Ubuntu 20.04+ with 2GB RAM is enough. Install Docker, run compose, and point a reverse proxy (Nginx/Caddy) at port 3000 with SSL.