Self-Hosting Guide

Run FeatureSignals on your own infrastructure for full control over your data and deployment.

Infrastructure Requirements

Minimum (Development/Small Teams)

• 1 VPS (2 CPU, 4GB RAM)
• PostgreSQL 14+
• Cost: ~$10-20/month

Recommended (Production)

• API Server: 2+ instances behind a load balancer
• Flag Engine: 1 instance (or static hosting)
• PostgreSQL: Managed or self-hosted with backups
• Relay Proxy: 1+ per region (optional)

Single VPS with Docker Compose

git clone https://github.com/dinesh-g1/featuresignals.git
cd featuresignals

cat > .env.production << 'EOF'
DATABASE_URL=postgres://fs:strong-password@localhost:5432/featuresignals?sslmode=disable
JWT_SECRET=generate-a-strong-random-secret-here
CORS_ORIGIN=https://flags.yourdomain.com
NEXT_PUBLIC_API_URL=https://api.yourdomain.com
EOF

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

Security Checklist

• Set a strong JWT_SECRET
• Use strong PostgreSQL passwords
• Enable SSL/TLS (via Caddy or reverse proxy)
• Restrict CORS_ORIGIN
• Set up database backups

Next Steps

• Configuration
• Docker Compose