Start
Installation
Three ways to run the gateway: the installer, a container, or nothing at all with the hosted gateway.
Releases are shared with customers on request, together with the download address for your account. The commands below use that address.
#The installer
On Linux and macOS:
curl -fsSL <download-address>/install.sh | shOn Windows (PowerShell):
irm <download-address>/install.ps1 | iexThe installer downloads the archive for your machine, checks its SHA-256 against checksums.txt, and installs two programs: rakuvo (the gateway) and rakuvo-api (the control plane, which is optional). It changes nothing else on your machine, and it refuses to install if the checksum does not match.
Options: --version 0.1.0 pins a version, --dir DIR chooses where the programs go, and --from-dir DIR installs from files you already downloaded, for machines with no internet access.
rakuvo version#Docker
docker run -d --name rakuvo -p 8081:8081 \ -e OPENAI_API_KEY -e RAKUVO_TOKEN \ <image>/rakuvo:0.1.0OPENAI_API_KEY is your model-provider key, which stays inside the container. RAKUVO_TOKEN is the bearer token your agent sends as its API key. The image holds only the compiled gateway: it has no shell, runs as a non-root user and reports its own health. See Self-hosting with Docker for Compose and the control plane.
#The archive, by hand
Download rakuvo_<version>_<os>_<arch>.tar.gz (.zip on Windows) and checksums.txt, check the hash, and unpack:
sha256sum -c --ignore-missing checksums.txttar -xzf rakuvo_0.1.0_linux_amd64.tar.gzBuilds are available for Linux and macOS on x86-64 and ARM, and for Windows on x86-64.
#No install: the hosted gateway
If you would rather not run anything, we run the gateway for you. See Hosted gateway.
#Running it somewhere other than your laptop
The gateway refuses to listen on a non-loopback address without authentication. Set -token-env to the name of an environment variable that holds a bearer token, and have your agent send it as its API key.