Quick Start Deployment Guide

One-Command Deployment

For the fastest deployment, use the automated deployment script:

# Download and run the deployment script
curl -sSL https://raw.githubusercontent.com/your-org/idrv5-myfr8/main/deploy.sh | bash -s -- \
    -d your-domain.com \
    -e admin@your-domain.com \
    -p SecurePassword123

Docker Deployment (Recommended)

1. Prerequisites

• Docker and Docker Compose installed
• Domain name pointing to your server
• SSL certificates (optional, can use Let’s Encrypt)

2. Quick Docker Setup

# Clone the repository
git clone https://github.com/your-org/idrv5-myfr8.git
cd idrv5-myfr8

# Copy environment template
cp .env.example .env

# Edit environment variables
nano .env

# Start the application
docker-compose up -d

# Check status
docker-compose ps

3. Environment Variables

Update .env file with your settings:

# Required Settings
DB_PASSWORD=your_secure_database_password
SESSION_SECRET=your_32_character_session_secret
JWT_SECRET_KEY=your_32_character_jwt_secret
SERVER_NAME=your-domain.com

# Optional External Services
TWILIO_ACCOUNT_SID=your_twilio_sid
SENDGRID_API_KEY=your_sendgrid_key
OPENAI_API_KEY=your_openai_key

Manual Deployment

1. System Requirements

• Ubuntu 20.04 LTS or CentOS 8+
• 4GB RAM minimum
• 20GB storage minimum
• PostgreSQL 14+
• Python 3.11+
• Nginx

2. Installation Steps

# Update system
sudo apt update && sudo apt upgrade -y

# Install dependencies
sudo apt install -y python3.11 python3.11-venv postgresql nginx

# Create application directory
sudo mkdir -p /opt/idrv5-myfr8
sudo chown $USER:$USER /opt/idrv5-myfr8

# Clone repository
git clone https://github.com/your-org/idrv5-myfr8.git /opt/idrv5-myfr8
cd /opt/idrv5-myfr8

# Setup virtual environment
python3.11 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Configure database
sudo -u postgres createdb idrv5_myfr8
sudo -u postgres createuser myfr8_user
sudo -u postgres psql -c "ALTER USER myfr8_user WITH PASSWORD 'secure_password';"
sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE idrv5_myfr8 TO myfr8_user;"

# Import database schema
psql -U myfr8_user -d idrv5_myfr8 -f exports/database_export_20250710_010237.sql

# Create environment file
cp .env.example .env
# Edit .env with your settings

# Start application
gunicorn --bind 0.0.0.0:5000 --workers 4 main:app

Cloud Platform Deployment

AWS EC2 with RDS

# Launch EC2 instance (t3.medium or larger)
# Create RDS PostgreSQL instance
# Update security groups for HTTP/HTTPS access

# Deploy application
curl -sSL https://raw.githubusercontent.com/your-org/idrv5-myfr8/main/deploy.sh | bash -s -- \
    -d your-domain.com \
    -e admin@your-domain.com \
    -p SecurePassword123

Google Cloud Platform

# Create Compute Engine instance
# Create Cloud SQL PostgreSQL instance
# Configure firewall rules

# Deploy application using Docker
docker-compose up -d

Azure

# Create Azure VM
# Create Azure Database for PostgreSQL
# Configure Network Security Groups

# Deploy application
./deploy.sh -d your-domain.com -e admin@your-domain.com -p SecurePassword123

Verification

After deployment, verify the application is working:

# Check health endpoint
curl https://your-domain.com/health

# Check application logs
sudo journalctl -u idrv5-myfr8 -f

# Access the application
# Open https://your-domain.com/operations in your browser

Post-Deployment

1. Configure External Services

Add API keys to your .env file:

# SMS notifications
TWILIO_ACCOUNT_SID=your_twilio_sid
TWILIO_AUTH_TOKEN=your_twilio_token

# Email notifications
SENDGRID_API_KEY=your_sendgrid_key

# AI features
OPENAI_API_KEY=your_openai_key

2. Set Up Monitoring

# Check application status
sudo systemctl status idrv5-myfr8

# Monitor logs
sudo journalctl -u idrv5-myfr8 -f

# Set up log rotation
sudo logrotate -f /etc/logrotate.d/idrv5-myfr8

3. Configure Backups

# Run backup manually
sudo /opt/scripts/backup.sh

# Check backup files
ls -la /opt/backups/

Troubleshooting

Common Issues

1. Application won’t start

   # Check logs
   sudo journalctl -u idrv5-myfr8 --no-pager
   
   # Check environment
   sudo -u www-data env
   
   # Test database connection
   psql -U myfr8_user -d idrv5_myfr8 -c "SELECT 1;"

2. Database connection errors

   # Check PostgreSQL status
   sudo systemctl status postgresql
   
   # Check connection string
   echo $DATABASE_URL
   
   # Test connection
   pg_isready -U myfr8_user -d idrv5_myfr8

3. SSL certificate issues

   # Renew certificate
   sudo certbot renew
   
   # Check certificate status
   sudo certbot certificates
   
   # Test Nginx configuration
   sudo nginx -t

Support

For additional help:

1. Check the full deployment guide: docs/DEPLOYMENT.md
2. Review the deployment checklist: docs/DEPLOYMENT_CHECKLIST.md
3. Contact support team

---

Last Updated: July 10, 2025