Production Deployment

Server requirements

Backend

• PHP 8.4+ with extensions: pdo_pgsql, mbstring, xml, curl, zip
• Composer 2.x
• PostgreSQL 18
• Redis (recommended for cache/queues)
• Nginx or Apache

Frontend

• Node.js 20+ (for build)
• Static web server (Nginx, Vercel, Netlify…)

Backend deployment

1. Clone and install

   git clone https://github.com/xetaio/XetaSuite-core.git
   cd XetaSuite-core
   composer install --no-dev --optimize-autoloader

2. Configure environment

   cp .env.example .env
   php artisan key:generate

   Edit .env:

   APP_ENV=production
   APP_DEBUG=false
   APP_URL=https://api.xetasuite.com
   
   DB_CONNECTION=pgsql
   DB_HOST=your-db-host
   DB_DATABASE=xetasuite
   DB_USERNAME=your-user
   DB_PASSWORD=your-password
   
   SANCTUM_STATEFUL_DOMAINS=xetasuite.com
   SESSION_DOMAIN=.xetasuite.com
   SPA_URL=https://xetasuite.com
   
   QUEUE_CONNECTION=redis
   CACHE_DRIVER=redis
   SESSION_DRIVER=database

3. Optimize for production

   php artisan config:cache
   php artisan route:cache
   php artisan view:cache
   php artisan event:cache

4. Run migrations

   php artisan migrate --force

5. Configure storage

   php artisan storage:link

Nginx configuration (Backend)

server {
    listen 443 ssl http2;
    server_name api.xetasuite.com;

    root /var/www/xetasuite-core/public;
    index index.php;

    ssl_certificate /path/to/certificate.crt;
    ssl_certificate_key /path/to/private.key;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Frontend deployment

1. Production build

   cd XetaSuite-React
   npm ci
   npm run build

2. Configure environment

   Create .env:

   VITE_API_URL=https://api.xetasuite.com

3. Deploy static files

   Upload the dist/ folder contents to your web server or CDN.

Nginx configuration (Frontend)

server {
    listen 443 ssl http2;
    server_name app.xetasuite.com;

    root /var/www/xetasuite-react/dist;
    index index.html;

    ssl_certificate /path/to/certificate.crt;
    ssl_certificate_key /path/to/private.key;

    location / {
        try_files $uri $uri/ /index.html;
    }

    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}

Queue workers

See the Queue Workers guide for setting up Supervisor or Systemd.

SSL certificates

Let's Encrypt

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d api.xetasuite.com -d app.xetasuite.com

Laravel Forge

Forge automatically manages SSL certificates with Let’s Encrypt.

Post-deployment checklist

• APP_DEBUG=false
• APP_ENV=production
• Caches generated (config:cache, route:cache, etc.)
• Queue worker running
• Scheduler cron configured
• SSL certificates installed
• Backups configured
• Monitoring set up