Repository navigation
Stalker GAMMA Server
--stalker-gamma-server-url
Experimental. This feature may change or be removed in future releases.
ModDB sometimes puts its pages behind a Cloudflare challenge, which makes addon downloads fail during full-install or update apply.
stalker-gamma-server is a small local web server that loads ModDB pages in a real (headless) Camoufox browser and solves the Cloudflare challenge when one appears. If you pass --stalker-gamma-server-url "http://localhost:5000", the CLI sends its ModDB page requests through this server instead of fetching them directly. The addon files themselves still download straight to your machine.
If you leave the switch out, the CLI works the same as before and doesn't use the server.
- Docker must be installed and running (Docker Desktop)
Download the server build for your platform from the Releases page:
stalker-gamma-server+{OS}.{ARCH}.{EXT}
Make sure Docker is running, then start the server in its own terminal and leave it open.
Windows (extract the zip first):
.\stalker-gamma-server.exeLinux:
chmod +x stalker-gamma-server+linux.x64.AppImage
./stalker-gamma-server+linux.x64.AppImagemacOS:
brew tap FaithBeam/stalker-gamma
brew install --cask stalker-gamma-server
stalker-gamma-serverThe server responds right away, but the browser container can take a while to start, especially on the first run while the image downloads. Check readiness with:
curl http://localhost:5000/readyz-
Healthymeans it's ready. -
Unhealthy(HTTP 503) means it's still starting, or Docker isn't running.
You don't have to wait for it to be ready before starting the install. The CLI waits for the server on its own if you provided --stalker-gamma-server-url.
If the browser stops responding, the server restarts the container automatically.
In a second terminal, pass the server URL to full-install:
stalker-gamma full-install --stalker-gamma-server-url http://localhost:5000The update apply command accepts the same switch:
stalker-gamma update apply --stalker-gamma-server-url http://localhost:5000When the install finishes, stop the server with Ctrl+C. This also removes its Docker container.
| Problem | Fix |
|---|---|
/readyz stays Unhealthy
|
Make sure Docker is running. Check the server's console output for errors. It retries every few seconds. |
ModDb temporarily blocked you. Try again in 1 hour. |
ModDB rate-limited your IP. Wait an hour and run the command again. |
The server has interactive API docs at http://localhost:5000/scalar. You only need these if you want to call the server directly.
- Why docker solution?
- Per OS solution is too much of a pain