qr-code_manager/DOMAIN_SETUP.md

QR Code Manager - Domain Setup Guide

Option 1: Using Nginx Reverse Proxy (Recommended)

1. Install Nginx

sudo apt update
sudo apt install nginx

2. Create Nginx Configuration

sudo nano /etc/nginx/sites-available/qr.moto-adv.com

Add this configuration:

server {
    listen 80;
    server_name qr.moto-adv.com;
    
    location / {
        proxy_pass http://localhost:8066;
        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;
        
        # Handle WebSocket connections if needed
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

3. Enable the Site

sudo ln -s /etc/nginx/sites-available/qr.moto-adv.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

4. DNS Configuration

Make sure your domain qr.moto-adv.com points to your server's IP address:

• Add an A record: qr.moto-adv.com -> YOUR_SERVER_IP

Option 2: Direct Docker Port Mapping

Modify docker-compose.yml

services:
  qr-manager:
    # ... other config
    ports:
      - "80:5000"  # Map port 80 directly to container

Then access via http://qr.moto-adv.com (without port number)

Option 3: SSL/HTTPS Setup (Production)

Using Certbot for Let's Encrypt SSL

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d qr.moto-adv.com

Testing Your Setup

1. Test locally first:

   curl http://localhost:8066
   # Should redirect to /login
   

2. Test domain (after DNS is configured):

   curl -H "Host: qr.moto-adv.com" http://localhost:8066
   

3. Access the dashboard:

   • Open: http://qr.moto-adv.com (or http://localhost:8066)
   • Username: ske087
   • Password: Matei@123

Current Working Credentials

✅ Admin Login:

• Username: ske087
• Password: Matei@123
• URL: http://localhost:8066/login

Health Check

Your app includes a health endpoint: http://localhost:8066/health

Troubleshooting

1. Check container status:

   docker compose ps
   docker compose logs qr-manager
   

2. Check port binding:

   netstat -tulpn | grep 8066
   

3. Test internal connectivity:

   docker exec -it qr-code-manager curl http://localhost:5000/health