quantum-website-2026/DOKPLOY-DEPLOYMENT.md

Dokploy Deployment Guide - Quantum Tasks AI Website

This guide explains how to deploy the Quantum Tasks AI static website on Dokploy.

Prerequisites

• Dokploy server running and accessible
• Domain name pointed to your Dokploy server
• Git repository with your website code
• Docker and Docker Compose support on Dokploy

Project Structure

quantumtaskai-website/
├── index.html              # Main homepage
├── digital-branding.html   # Digital branding page
├── css/                    # Stylesheets
├── js/                     # JavaScript files
├── img/                    # Images and assets
├── Dockerfile              # Docker configuration
├── docker-compose.yml      # Docker Compose configuration
├── dokploy.json           # Dokploy-specific configuration
├── .dockerignore          # Docker ignore file
└── DOKPLOY-DEPLOYMENT.md  # This file

Deployment Files

1. Dockerfile

The Dockerfile uses nginx:alpine to serve the static website with:

• Security headers (X-Frame-Options, X-Content-Type-Options, etc.)
• Optimized caching for static assets (1 year for CSS/JS/images, 1 hour for HTML)
• SPA routing support with fallback to index.html

2. docker-compose.yml

Configured with:

• Traefik labels for automatic SSL and routing
• Health checks
• Production environment settings
• Network configuration for Dokploy

3. dokploy.json

Dokploy-specific configuration including:

• Domain settings with automatic SSL
• Resource limits (256M memory, 0.5 CPU)
• Health check configuration
• Security and monitoring settings

Deployment Steps

Method 1: Git Repository Deployment (Recommended)

1. Push your code to a Git repository (GitHub, GitLab, etc.)

2. Access Dokploy Dashboard

   • Open your Dokploy web interface
   • Navigate to Applications/Services

3. Create New Application

   • Click "Create Application"
   • Choose "Compose" as the application type
   • Name: quantumtaskai-website

4. Configure Git Source

   • Repository URL: https://github.com/your-username/quantumtaskai-website.git
   • Branch: main (or your main branch)
   • Build Path: . (root directory)

5. Domain Configuration

   • Primary domain: quantumtaskai.com
   • Additional domain: www.quantumtaskai.com (with redirect)
   • Enable SSL/TLS with Let's Encrypt

6. Environment Variables

   NODE_ENV=production
   

7. Deploy

   • Click "Deploy"
   • Monitor build logs
   • Wait for deployment completion

Method 2: Direct File Upload

1. Package your files

   cd /path/to/quantumtaskai-website
   tar -czf quantumtaskai-website.tar.gz .
   

2. Upload to Dokploy

   • Use Dokploy's file upload feature
   • Upload the tar.gz file
   • Extract in the application directory

3. Configure and deploy (same as Method 1, steps 5-7)

Post-Deployment Configuration

1. Domain DNS Setup

Point your domain to your Dokploy server:

Type: A
Name: @
Value: YOUR_DOKPLOY_SERVER_IP

Type: A  
Name: www
Value: YOUR_DOKPLOY_SERVER_IP

2. SSL Certificate

Dokploy will automatically generate Let's Encrypt certificates for:

• quantumtaskai.com
• www.quantumtaskai.com

3. Health Checks

The application includes health checks that:

• Check every 30 seconds
• Timeout after 10 seconds
• Retry up to 3 times
• Allow 30 seconds startup time

Monitoring and Maintenance

Application Monitoring

Dokploy provides built-in monitoring for:

• CPU usage
• Memory usage
• Network traffic
• Application health status

Logs

Access application logs through Dokploy dashboard:

• Container logs
• Nginx access logs
• Error logs

Updates and Redeployment

For Git-based deployment:

1. Push changes to your Git repository
2. Trigger redeploy in Dokploy dashboard
3. Monitor deployment progress

For file-based deployment:

1. Update files locally
2. Create new package: tar -czf update.tar.gz .
3. Upload and redeploy through Dokploy

Troubleshooting

Common Issues

1. Build Failures

• Check Docker build logs in Dokploy
• Verify all files are present
• Check .dockerignore isn't excluding necessary files

2. SSL Certificate Issues

• Ensure domain DNS is pointing to Dokploy server
• Wait 5-10 minutes for DNS propagation
• Check Let's Encrypt rate limits

3. Application Not Accessible

• Verify port 80 and 443 are open on Dokploy server
• Check domain configuration in Dokploy
• Verify container is running and healthy

4. Static Files Not Loading

• Check nginx configuration in Dockerfile
• Verify file paths in HTML are correct
• Check browser developer tools for 404 errors

Debug Commands

Check container status:

docker ps | grep quantumtaskai-website

View container logs:

docker logs quantumtaskai-website

Test container locally:

docker build -t quantumtaskai-website .
docker run -p 8080:80 quantumtaskai-website

Performance Optimization

Caching Strategy

The nginx configuration implements:

• 1 year cache for static assets (CSS, JS, images)
• 1 hour cache for HTML files
• Proper cache headers for SEO

Resource Usage

• Memory limit: 256MB
• CPU limit: 0.5 cores
• Suitable for static website with moderate traffic

Scaling

For higher traffic:

1. Increase resource limits in dokploy.json
2. Consider using CDN for static assets
3. Enable Dokploy's load balancing features

Security Features

Built-in Security Headers

• X-Frame-Options: SAMEORIGIN
• X-Content-Type-Options: nosniff
• X-XSS-Protection: 1; mode=block

SSL/TLS

• Automatic HTTPS redirect
• Strong cipher suites
• HTTP/2 support

Network Security

• Container isolated in Docker network
• Only necessary ports exposed (80, 443)
• Firewall rules configured

Backup Strategy

The static website doesn't require database backups, but consider:

• Regular Git repository backups
• Dokploy configuration export
• Domain and SSL certificate documentation

Support

For issues with:

• Dokploy Platform: Check Dokploy documentation
• Website Content: Review HTML/CSS/JS files
• Domain/SSL: Contact your domain registrar
• Server Issues: Check with your hosting provider

Your Quantum Tasks AI website should now be successfully deployed on Dokploy with automatic SSL, monitoring, and optimized performance!