Docs

GPT-Load 2.0 documentation

Organized by task rather than mirroring a directory tree. To understand the project first, return to the home page; this section is for getting work done.

Search documentation

Install it

One Compose command and a management key in five minutes

Configure it

Groups face upstream; AccessKeys face applications

Connect it

Change the base URL and API key; keep the client

01Getting started

Quick startFrom zero to the first successful request in about ten minutes Core conceptsThe two-layer Group and AccessKey model DeploymentDocker Compose, native binaries, and source builds Known limitations and versioningRuntime boundaries and release channels to check before upgrading

02Configuration

Groups and channels24 built-in channels, Group settings, and credential pools Subscription accountsOAuth for Codex, Claude, Antigravity, and Grok ModelsDiscovery, aliases, and pricing AccessKeysScope, rate limits, and cost limits Client setupClaude Code, Codex, Cherry Studio, and more

03Operations

Monitoring and troubleshootingHealth, request logs, route inspection, usage, and cost Runtime settingsTimeouts, retries, affinity, and other runtime controls Database and backupThree drivers, DSNs, migrations, and recovery Security and productionTwo keys, network boundaries, and a launch checklist

04Internals

How scheduling worksWeights, affinity, retries, cooldown, and blacklisting Protocols and conversion boundariesFour protocols and the conversions they do or do not support Proxies and headersOutbound proxies, override precedence, and request-header rules

05Reference

Channel capability matrixProtocols, operations, proxy support, and validation by channel Environment variablesComplete process configuration reference Management APIScripted management of Groups and AccessKeys Errors and recoveryError codes, request-log fields, route reasons, and remediation FAQCommon deployment, integration, and troubleshooting questions Moving from 1.xRun 2.0 in parallel; in-place upgrades are not supported

1.4.x

Still using 1.4.x? Its documentation remains available in the 1.4.x docs. Version 2.0 cannot be upgraded in place or import 1.x data; follow Moving from 1.x.