digiserver-v2/old_code_documentation/DEPLOYMENT_COMMANDS.md

DigiServer Deployment Commands

This document contains all necessary docker exec commands to deploy and configure DigiServer on a new PC with the same settings as the production system.

Prerequisites

# Ensure you're in the project directory
cd /path/to/digiserver-v2

# Start the containers
docker-compose up -d

1. Database Initialization and Migrations

Run all database migrations in sequence:

# Create https_config table
docker-compose exec -T digiserver-app python /app/migrations/add_https_config_table.py

# Create player_user table  
docker-compose exec -T digiserver-app python /app/migrations/add_player_user_table.py

# Add email to https_config table
docker-compose exec -T digiserver-app python /app/migrations/add_email_to_https_config.py

# Migrate player_user global settings
docker-compose exec -T digiserver-app python /app/migrations/migrate_player_user_global.py

Note: The -T flag prevents Docker from allocating a pseudo-terminal, which is useful for automated deployments.

2. HTTPS Configuration via CLI

Check HTTPS Configuration Status:

docker-compose exec -T digiserver-app python /app/https_manager.py status

Enable HTTPS with Production Settings:

docker-compose exec -T digiserver-app python /app/https_manager.py enable \
    digiserver \
    digiserver.sibiusb.harting.intra \
    admin@example.com \
    10.76.152.164 \
    443

Show Detailed Configuration:

docker-compose exec -T digiserver-app python /app/https_manager.py show

3. Admin User Setup

Create/Reset Admin User (if needed):

docker-compose exec -T digiserver-app python -c "
from app.app import create_app
from app.models.user import User
from app.extensions import db

app = create_app()
with app.app_context():
    # Check if admin exists
    admin = User.query.filter_by(username='admin').first()
    if admin:
        print('✅ Admin user already exists')
    else:
        # Create new admin user
        admin = User(username='admin', email='admin@example.com')
        admin.set_password('admin123')  # Change this password!
        admin.is_admin = True
        db.session.add(admin)
        db.session.commit()
        print('✅ Admin user created with username: admin')
"

4. Database Verification

Check Database Tables:

docker-compose exec -T digiserver-app python -c "
from app.app import create_app
from app.extensions import db
from sqlalchemy import inspect

app = create_app()
with app.app_context():
    inspector = inspect(db.engine)
    tables = inspector.get_table_names()
    print('📊 Database Tables:')
    for table in sorted(tables):
        print(f'  ✓ {table}')
    print(f'\\n✅ Total tables: {len(tables)}')
"

Check HTTPS Configuration in Database:

docker-compose exec -T digiserver-app python -c "
from app.app import create_app
from app.models.https_config import HTTPSConfig

app = create_app()
with app.app_context():
    config = HTTPSConfig.get_config()
    if config:
        print('✅ HTTPS Configuration Found:')
        print(f'   Status: {\"ENABLED\" if config.https_enabled else \"DISABLED\"}')
        print(f'   Hostname: {config.hostname}')
        print(f'   Domain: {config.domain}')
        print(f'   IP Address: {config.ip_address}')
        print(f'   Port: {config.port}')
    else:
        print('⚠️  No HTTPS configuration found')
"

5. Health Checks

Test Caddy Configuration:

docker-compose exec -T caddy caddy validate --config /etc/caddy/Caddyfile

Test Flask Application Health:

docker-compose exec -T digiserver-app python -c "
import urllib.request
try:
    response = urllib.request.urlopen('http://localhost:5000/health', timeout=5)
    print('✅ Application is responding')
    print(f'   Status: {response.status}')
except Exception as e:
    print(f'❌ Application health check failed: {e}')
"

Check Docker Container Logs:

# Flask app logs
docker-compose logs digiserver-app | tail -50

# Caddy logs  
docker-compose logs caddy | tail -50

6. Complete Deployment Script

Create a file called deploy.sh to run all steps automatically:

#!/bin/bash
set -e

echo "🚀 DigiServer Deployment Script"
echo "=================================="
echo ""

# Change to project directory
cd /path/to/digiserver-v2

# Step 1: Start containers
echo "📦 Starting containers..."
docker-compose up -d
sleep 5

# Step 2: Run migrations
echo "📊 Running database migrations..."
docker-compose exec -T digiserver-app python /app/migrations/add_https_config_table.py
docker-compose exec -T digiserver-app python /app/migrations/add_player_user_table.py
docker-compose exec -T digiserver-app python /app/migrations/add_email_to_https_config.py
docker-compose exec -T digiserver-app python /app/migrations/migrate_player_user_global.py

# Step 3: Configure HTTPS
echo "🔒 Configuring HTTPS..."
docker-compose exec -T digiserver-app python /app/https_manager.py enable \
    digiserver \
    digiserver.sibiusb.harting.intra \
    admin@example.com \
    10.76.152.164 \
    443

# Step 4: Verify setup
echo "✅ Verifying setup..."
docker-compose exec -T digiserver-app python /app/https_manager.py status

echo ""
echo "🎉 Deployment Complete!"
echo "=================================="
echo "Access your application at:"
echo "  - https://digiserver"
echo "  - https://10.76.152.164"
echo "  - https://digiserver.sibiusb.harting.intra"
echo ""
echo "Login with:"
echo "  Username: admin"
echo "  Password: (check your password settings)"

Make it executable:

chmod +x deploy.sh

Run it:

./deploy.sh

7. Troubleshooting

Restart Services:

# Restart all containers
docker-compose restart

# Restart just the app
docker-compose restart digiserver-app

# Restart just Caddy
docker-compose restart caddy

View Caddy Configuration:

docker-compose exec -T caddy cat /etc/caddy/Caddyfile

Test HTTPS Endpoints:

# Test from host machine (if accessible)
curl -k https://digiserver.sibiusb.harting.intra

# Test from within containers
docker-compose exec -T caddy wget --no-check-certificate -qO- https://localhost/ | head -20

Clear Caddy Cache (if certificate issues occur):

docker volume rm digiserver-v2_caddy-data
docker volume rm digiserver-v2_caddy-config
docker-compose restart caddy

Important Notes

• Always use -T flag with docker-compose exec in automated scripts to prevent TTY issues
• Change default passwords (admin123) in production environments
• Adjust email address in HTTPS configuration as needed
• For different network setups, modify the IP address and domain in the enable HTTPS command
• Keep database backups before running migrations
• Test all three access points after deployment