# 🚀 VIP Coordinator - Standalone Installation Deploy VIP Coordinator directly from Docker Hub - **No GitHub required!** ## 📦 What You Get - ✅ **Pre-built Docker images** from Docker Hub - ✅ **Interactive setup script** that configures everything - ✅ **Complete deployment** in under 5 minutes - ✅ **No source code needed** - just Docker containers ## 🔧 Prerequisites **Ubuntu/Linux:** ```bash # Install Docker and Docker Compose sudo apt update sudo apt install docker.io docker-compose sudo usermod -aG docker $USER # Log out and back in, or run: newgrp docker ``` **Other Systems:** - Install Docker Desktop from https://docker.com/get-started ## 🚀 Installation Methods ### Method 1: Direct Download (Recommended) ```bash # Create directory mkdir vip-coordinator cd vip-coordinator # Download the standalone setup script curl -O https://your-domain.com/standalone-setup.sh # Make executable and run chmod +x standalone-setup.sh ./standalone-setup.sh ``` ### Method 2: Copy-Paste Installation If you can't download the script, you can create it manually: ```bash # Create directory mkdir vip-coordinator cd vip-coordinator # Create the setup script (copy the content from standalone-setup.sh) nano standalone-setup.sh # Make executable and run chmod +x standalone-setup.sh ./standalone-setup.sh ``` ### Method 3: Manual Docker Hub Deployment If you prefer to set up manually: ```bash # Create directory mkdir vip-coordinator cd vip-coordinator # Create docker-compose.yml cat > docker-compose.yml << 'EOF' version: '3.8' services: db: image: postgres:15 environment: POSTGRES_DB: vip_coordinator POSTGRES_PASSWORD: ${DB_PASSWORD} volumes: - postgres-data:/var/lib/postgresql/data restart: unless-stopped healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 30s timeout: 10s retries: 3 redis: image: redis:7 restart: unless-stopped healthcheck: test: ["CMD", "redis-cli", "ping"] interval: 30s timeout: 10s retries: 3 backend: image: t72chevy/vip-coordinator:backend-latest environment: DATABASE_URL: postgresql://postgres:${DB_PASSWORD}@db:5432/vip_coordinator REDIS_URL: redis://redis:6379 GOOGLE_CLIENT_ID: ${GOOGLE_CLIENT_ID} GOOGLE_CLIENT_SECRET: ${GOOGLE_CLIENT_SECRET} GOOGLE_REDIRECT_URI: ${GOOGLE_REDIRECT_URI} FRONTEND_URL: ${FRONTEND_URL} ADMIN_PASSWORD: ${ADMIN_PASSWORD} PORT: 3000 ports: - "3000:3000" depends_on: db: condition: service_healthy redis: condition: service_healthy restart: unless-stopped frontend: image: t72chevy/vip-coordinator:frontend-latest ports: - "80:80" depends_on: - backend restart: unless-stopped volumes: postgres-data: EOF # Create .env file with your configuration nano .env # Start the application docker-compose pull docker-compose up -d ``` ## 🎯 What the Setup Script Does 1. **Checks Prerequisites**: Verifies Docker and Docker Compose are installed 2. **Interactive Configuration**: Asks for your deployment preferences 3. **Generates Files**: Creates all necessary configuration files 4. **Pulls Images**: Downloads pre-built images from Docker Hub 5. **Creates Management Scripts**: Provides easy start/stop/update commands ## 📋 Configuration Options The script will ask you for: - **Deployment Type**: Local development or production - **Domain Settings**: Your domain names (for production) - **Security**: Generates secure passwords automatically - **Google OAuth**: Your Google Cloud Console credentials - **Optional**: AviationStack API key for flight data ## 🔐 Google OAuth Setup You'll need to set up Google OAuth (the script guides you through this): 1. Go to [Google Cloud Console](https://console.cloud.google.com/) 2. Create a new project 3. Enable Google+ API 4. Create OAuth 2.0 Client ID 5. Add redirect URI (provided by the script) 6. Copy Client ID and Secret ## 📦 Docker Hub Images Used This deployment uses these pre-built images: - **`t72chevy/vip-coordinator:backend-latest`** (404MB) - Complete Node.js backend with OAuth fixes - PostgreSQL and Redis integration - Health checks and monitoring - **`t72chevy/vip-coordinator:frontend-latest`** (74.8MB) - React frontend with mobile OAuth fixes - Nginx web server - Production-optimized build - **`postgres:15`** - Database - **`redis:7`** - Cache and sessions ## 🚀 After Installation Once setup completes, you'll have these commands: ```bash ./start.sh # Start VIP Coordinator ./stop.sh # Stop VIP Coordinator ./update.sh # Update to latest Docker Hub images ./status.sh # Check system status ./logs.sh # View application logs ``` ## 🌐 Access Your Application - **Local**: http://localhost - **Production**: https://your-domain.com ## 🔄 Updates To update to the latest version: ```bash ./update.sh ``` This pulls the latest images from Docker Hub and restarts the services. ## 📱 Mobile Support This deployment includes fixes for mobile OAuth authentication: - ✅ Mobile users can now log in successfully - ✅ Proper API endpoint configuration - ✅ Enhanced error handling ## 🛠️ Troubleshooting ### Common Issues **Docker permission denied:** ```bash sudo usermod -aG docker $USER newgrp docker ``` **Port conflicts:** ```bash # Check what's using ports 80 and 3000 sudo netstat -tulpn | grep :80 sudo netstat -tulpn | grep :3000 ``` **Service not starting:** ```bash ./status.sh # Check status ./logs.sh # View logs ``` ## 📞 Distribution To share VIP Coordinator with others: 1. **Share the setup script**: Give them `standalone-setup.sh` 2. **Share this guide**: Include `STANDALONE_INSTALL.md` 3. **No GitHub needed**: Everything pulls from Docker Hub ## 🎉 Benefits of Standalone Deployment - ✅ **No source code required** - ✅ **No GitHub repository needed** - ✅ **Pre-built, tested images** - ✅ **Automatic updates from Docker Hub** - ✅ **Cross-platform compatibility** - ✅ **Production-ready configuration** --- **🚀 Get VIP Coordinator running in under 5 minutes with just Docker and one script!**