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:

bash
curl -fsSL <download-address>/install.sh | sh

On Windows (PowerShell):

powershell
irm <download-address>/install.ps1 | iex

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

bash
rakuvo version

#Docker

bash
docker run -d --name rakuvo -p 8081:8081 \
-e OPENAI_API_KEY -e RAKUVO_TOKEN \
<image>/rakuvo:0.1.0

OPENAI_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:

bash
sha256sum -c --ignore-missing checksums.txt
tar -xzf rakuvo_0.1.0_linux_amd64.tar.gz

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