vip-coordinator/STANDALONE_INSTALL.md

# 🚀 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!**