OpenQAOpenQA
Deployment

Production Deployment Guide

Deploy OpenQA to production in minutes with our automated installer or manual setup.

Quick Deploy (5 minutes)

Use our interactive installer to deploy OpenQA:

bash
1# Interactive installer - Choose Docker, VPS, or Cloud
2curl -fsSL https://openqa.orkajs.com/install-production.sh | bash

Deployment Options

MethodTimeDifficultyBest For
🐳 Docker5 minEasyVPS, Local servers
🖥️ VPS/Systemd15 minMediumFull control
☁️ Railway3 minEasiestQuick deploy
🎨 Render2 minEasiestFree tier
🪰 Fly.io5 minEasyGlobal edge

Requirements

  • Node.js 20+ (for VPS deployment)
  • Docker (for containerized deployment)
  • LLM API Key (OpenAI, Anthropic, or Ollama)
  • Target Application URL (the app you want to test)

Required Environment Variables

bash
1# Required
2OPENAI_API_KEY=sk-xxx          # Or ANTHROPIC_API_KEY
3OPENQA_JWT_SECRET=xxx          # Generate: openssl rand -hex 32
4SAAS_URL=https://your-app.com  # Target application
5 
6# Recommended
7NODE_ENV=production
8WEB_PORT=4242

First-Time Setup

  1. Access the dashboard at http://your-server:4242
  2. You'll be redirected to /setup
  3. Create your admin account with a strong password
  4. Log in and configure your environment at /config/env

Security Checklist

Before going live:

  • ✅ Set strong OPENQA_JWT_SECRET (64+ chars)
  • ✅ Use strong admin password (min 12 chars)
  • ✅ Enable HTTPS (SSL certificate)
  • ✅ Never set OPENQA_AUTH_DISABLED=true
  • ✅ Set NODE_ENV=production
  • ✅ Restrict CORS origins
  • ✅ Enable firewall (ports 80, 443 only)
  • ✅ Setup automated backups

Next Steps