Download & Run

1. Get the artifact

Prebuilt binaries are available for Linux (amd64, arm64) and macOS (Apple Silicon), or pull the Docker image. Head to the download page to grab the one you need.

2. Run the prebuilt binary

Make the downloaded artifact executable and start the service, pointing it at a config file (see config.example.yaml in the repo for every available option).

chmod +x anonymix_linux_amd64-v1.0.0
./anonymix_linux_amd64-v1.0.0 -config config.yaml

The binary listens on the address configured by server.listen_addr in the YAML file, or via the ANON_SERVER__LISTEN_ADDR environment override. Passing -healthcheck instead of starting the server probes the local /healthz endpoint and exits — handy for container HEALTHCHECK directives on minimal images that lack curl/wget.

3. Or run the Dockerized solution

Pull the container image and run it locally on port 8080.

docker pull anonymixdev/anonymix:latest
docker run -p 8080:8080 anonymixdev/anonymix:latest

Mount a custom config

docker run -p 8080:8080 \
  -v "$PWD/config.yaml:/etc/anonymix/config.yaml:ro" \
  anonymixdev/anonymix:latest

Persist the trial license across restarts

An ephemeral container filesystem means a fresh 30-day trial on every docker run. To keep the trial anchored to its original start date across restarts, mount a named volume at /var/lib/anonymix:

docker volume create anonymix-state
docker run -p 8080:8080 \
  -v anonymix-state:/var/lib/anonymix \
  -v "$PWD/config.yaml:/etc/anonymix/config.yaml:ro" \
  anonymixdev/anonymix:latest

4. Verify it's up

curl localhost:8080/healthz

Next, see Licensing to activate a key, then Use as a REST API or Use as a Filter/Proxy to start sending traffic.