Thymis Documentation

On this page

Using nix run

You can run the Thymis Controller directly with Nix, without installing NixOS or using Docker.

nix run github:Thymis-io/thymis/v0.7#thymis-controller

This starts the controller binary from the pinned release.

Configuration is done via the same environment variables as in the OCI‑Container setup:

  • THYMIS_BASE_URL
  • THYMIS_AGENT_ACCESS_URL
  • THYMIS_PROJECT_PATH
  • THYMIS_AUTH_BASIC
  • THYMIS_AUTH_BASIC_USERNAME
  • THYMIS_AUTH_BASIC_PASSWORD_FILE
  • UVICORN_HOST
  • UVICORN_PORT

Example:

THYMIS_BASE_URL=https://your-domain.example 
THYMIS_AGENT_ACCESS_URL=https://your-domain.example 
THYMIS_PROJECT_PATH=/var/lib/thymis 
UVICORN_HOST=0.0.0.0 
UVICORN_PORT=8000 
mkdir -p /var/lib/thymis && 
nix run github:Thymis-io/thymis/v0.7#thymis-controller

Notes:

  • Runs the same app as the container, but builds execute natively on your host.
  • Ensure THYMIS_PROJECT_PATH exists and is writable (e.g., /var/lib/thymis).
  • For public exposure and TLS, put a reverse proxy in front of the process.
ende