System Requirements
Before you enable the Docker container, ensure your environment is ready.
🖥️ Server (VPS)
You need a Virtual Private Server (VPS). Since TriviaFlow is fully containerized, it runs on almost any Linux distribution, but we optimize for stability.
Recommended OS
| OS | Version | Status |
|---|---|---|
| Debian | 12 (Bookworm) / 13 (Trixie) | ✅ Recommended |
| Ubuntu | 22.04 LTS / 24.04 LTS | ✅ Supported |
| Fedora | Latest | ⚠️ Works |
Hardware
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 1 vCore | 2 vCores |
| RAM | 1 GB | 2 GB+ |
| Storage | 10 GB SSD | 20 GB NVMe |
| Ports | 80, 443, 22 | Open in firewall |
🌐 Domain Name
You need a public domain (e.g., quiz.your-domain.com) pointing to your server's IP address (A Record).
This is required for SSL/HTTPS (handled automatically by Caddy).
- Game URL: [
quiz.your-domain.com] ->YOUR_SERVER_IP - Database (Optional): [
db.your-domain.com] ->YOUR_SERVER_IP
🛠️ Required Tools
You will need the following tools installed on your server before starting the deployment workflow.
1. Git
Required to fetch the source code.
- Debian / Ubuntu
- RedHat / Fedora
sudo apt update && sudo apt install git -y
sudo dnf install git -y
2. Docker
The application runs entirely in Docker. If you don't have it installed yet, don't worry—the Deployment Guide covers the installation step in detail.
Once you have your server and domain ready, proceed to the Deployment Guide.