Skip to content

Stalker GAMMA Server

FaithBeam edited this page Oct 28, 2026 · 15 revisions

--stalker-gamma-server-url

Experimental. This feature may change or be removed in future releases.

What it does

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.

Requirements

1. Download the server

Download the server build for your platform from the Releases page:

stalker-gamma-server+{OS}.{ARCH}.{EXT}

2. Start the server

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.exe

Linux:

chmod +x stalker-gamma-server+linux.x64.AppImage
./stalker-gamma-server+linux.x64.AppImage

macOS:

brew tap FaithBeam/stalker-gamma
brew install --cask stalker-gamma-server
stalker-gamma-server

Check that it's ready

The 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
  • Healthy means 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.

3. Run the install with the server

In a second terminal, pass the server URL to full-install:

stalker-gamma full-install --stalker-gamma-server-url http://localhost:5000

The update apply command accepts the same switch:

stalker-gamma update apply --stalker-gamma-server-url http://localhost:5000

When the install finishes, stop the server with Ctrl+C. This also removes its Docker container.

Troubleshooting

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.

API docs

The server has interactive API docs at http://localhost:5000/scalar. You only need these if you want to call the server directly.

FAQ

  • Why docker solution?
    • Per OS solution is too much of a pain

Clone this wiki locally