Self-Hosted Deployment

Deploy ATStatus on your own VPS, dedicated server, or on-premises infrastructure. Self-hosting gives you complete control over your data and deployment configuration.

Requirements

Hardware Recommendations

Setup Steps

Server Setup

# Clone repository
git clone https://github.com/your-org/atstatus.git
cd atstatus

# Install dependencies
npm ci --production

# Configure environment
cp .env.example .env
nano .env

# Generate Prisma client
npx prisma generate

# Run migrations
npx prisma migrate deploy

# Build application
npm run build

PM2 Process Manager

PM2 is recommended for production deployments. It provides:

# Install PM2 globally
npm install -g pm2

# Create ecosystem file
cat > ecosystem.config.js << 'EOF'
module.exports = {
  apps: [{
    name: 'atstatus',
    script: 'npm',
    args: 'start',
    cwd: '/opt/atstatus',
    env: {
      NODE_ENV: 'production',
      PORT: 3000
    },
    instances: 1,
    autorestart: true,
    max_memory_restart: '1G'
  }]
}
EOF

# Start application
pm2 start ecosystem.config.js

# Save PM2 configuration
pm2 save

# Enable startup on boot
pm2 startup

NGINX Configuration

server {
    listen 80;
    server_name status.example.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name status.example.com;

    ssl_certificate /etc/letsencrypt/live/status.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/status.example.com/privkey.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}

Security Checklist

SSL with Certbot

# Install Certbot
sudo apt install certbot python3-certbot-nginx

# Obtain certificate
sudo certbot --nginx -d status.example.com

# Auto-renewal is configured automatically
# Test renewal with:
sudo certbot renew --dry-run

Next Steps