Quick Start

Get GPT-Load up and running quickly with these steps.

Quick Launch

Lightweight Deployment

Uses SQLite database and memory storage, perfect for personal use and quick testing

System Requirements

  • Docker 20.10+ and Docker Compose
  • Linux/macOS/Windows operating systems
  • At least 128MB memory and 1GB disk space

Installation Steps

🚨

Important Security Notice

You must change the default management key before deployment!

  • Use at least 20 characters for complex keys
  • Include uppercase, lowercase, numbers and special characters
  • Never use sk-123456 or other default/simple keys
  • Using weak keys in production environments poses serious security risks

Recommended key format: sk-prod-[random string32characters]

1

Create Working Directory

# Create directory and enter
mkdir -p gpt-load && cd gpt-load
2

Download Configuration Files

# Download Docker Compose configuration
wget https://raw.githubusercontent.com/tbphp/gpt-load/refs/heads/main/docker-compose.yml

# Download environment variable configuration
wget -O .env https://raw.githubusercontent.com/tbphp/gpt-load/refs/heads/main/.env.example
🔐
Modify Security Configuration Immediately

Edit .env file, change the following:

AUTH_KEY=sk-123456

to a strong key:

AUTH_KEY=sk-prod-your-strong-random-key-32-chars
3

Start Services

# Start GPT-Load service
docker compose up -d
4

Verify Deployment

Access admin interface:

http://localhost:3001

Use the .env set in theAUTH_KEY file to login to the admin interface

Common Commands

Check Status

docker compose ps

View Logs

docker compose logs -f

Restart Service

docker compose down && docker compose up -d

Update Version

docker compose pull && docker compose down && docker compose up -d

Want to learn more deployment options, such as using MySQL/PostgreSQL or cluster deployment? Check out the complete Deployment Guide.