# Docker Setup Guide

This guide explains how to run the Ultimate Lists App using Docker on port 3500.

## Prerequisites

- Docker and Docker Compose installed
- MySQL server running (external to Docker)
- Environment variables configured

## Configuration

### 1. Update next.config.js

The application needs to be configured for standalone output. Update your `next.config.js`:

```javascript
const nextConfig = {
  output: 'standalone',
  // ... rest of your config
}
```

### 2. Environment Variables

Create a `.env` file in the project root with your MySQL connection details:

```env
# MySQL Connection (external server)
DATABASE_URL="mysql://user:password@host:port/database"

# For Docker host machine MySQL, use:
# DATABASE_URL="mysql://user:password@host.docker.internal:3306/database"

# NextAuth Configuration
NEXTAUTH_URL=http://localhost:3500
NEXTAUTH_SECRET=your-secret-key-here
AUTH_SECRET=your-secret-key-here

# Optional: MySQL connection check variables
DB_HOST=host.docker.internal
DB_PORT=3306
DB_USER=your-db-user
DB_PASSWORD=your-db-password
```

**Important:** If your MySQL server is running on your host machine (localhost), use `host.docker.internal` instead of `localhost` in the DATABASE_URL.

### 3. Run Database Migrations

Before building the Docker image, ensure your database schema is up to date:

```bash
npm install
npx prisma generate
npx prisma db push
```

## Building and Running

### Option 1: Using Docker Compose (Recommended)

```bash
# Build and start the container
docker-compose up -d

# View logs
docker-compose logs -f app

# Stop the container
docker-compose down
```

### Option 2: Using Docker directly

```bash
# Build the image
docker build -t ultimate-lists-app .

# Run the container
docker run -d \
  -p 3500:3500 \
  --env-file .env \
  --name ultimate-lists-app \
  ultimate-lists-app

# View logs
docker logs -f ultimate-lists-app

# Stop the container
docker stop ultimate-lists-app
docker rm ultimate-lists-app
```

## Accessing the Application

Once running, access the application at:
- **http://localhost:3500**

## Troubleshooting

### Cannot connect to MySQL

If you see database connection errors:

1. Verify MySQL is running and accessible
2. Check that you're using `host.docker.internal` instead of `localhost` in DATABASE_URL
3. Ensure MySQL allows connections from Docker containers
4. Verify firewall settings allow the connection

### Build fails

If the build fails:

1. Ensure `output: 'standalone'` is set in `next.config.js`
2. Check that all dependencies are properly installed
3. Verify Prisma schema is valid

### Port already in use

If port 3500 is already in use:

```bash
# Find what's using the port
lsof -i :3500

# Change the port in docker-compose.yml or use a different port:
docker run -p 3501:3500 ...
```

## Development vs Production

This Docker setup is configured for production use. For development:

```bash
# Use the regular dev server
npm run dev
```

## Updating the Application

To update after code changes:

```bash
# Rebuild and restart
docker-compose up -d --build

# Or with Docker directly
docker build -t ultimate-lists-app .
docker stop ultimate-lists-app
docker rm ultimate-lists-app
docker run -d -p 3500:3500 --env-file .env --name ultimate-lists-app ultimate-lists-app
```