Skip to content

Download & Install

Download

Get GPROXY

One gateway in front of every LLM provider. Pick the desktop Application, the headless-capable CLI, a container image, or a hosted deployment — every build ships from the same signed release.

Latest release …Reading the latest release…Release notes ↗All releasesNightly builds

One-line install

Installs the CLI for this computer and walks you through the database, administrator account and proxy. For the desktop Application, download it below.

Linux · macOS · Termux

curl -fsSL https://gproxy.leenhawk.com/install.sh | sh

Windows PowerShell

irm https://gproxy.leenhawk.com/install.ps1 | iex
Skip the questions

Add -y and any options to install without prompts. Run the script with --help to see them all.

curl -fsSL https://gproxy.leenhawk.com/install.sh | sh -s -- -y --edition headless --proxy http://127.0.0.1:7890
& ([scriptblock]::Create((irm https://gproxy.leenhawk.com/install.ps1))) -Yes -Edition headless

All platforms

macOS

Choose ARM64 for Apple Silicon. Apps are ad-hoc signed and not notarized; allow them in System Settings on first launch.

ApplicationCLI
ARM64DMGZIPZIPDMG
x86_64DMGZIPZIPDMG

Android

The Application is an APK. The CLI runs inside Termux: install the DEB with apt, or unpack the ZIP and follow TERMUX.txt.

ApplicationCLI
ARM64APKTermux DEBZIP
x86_64APKTermux DEBZIP

After installing

Application

Open GPROXY. A short wizard asks for the port and data folder, an administrator name and password, and an optional configuration to import. Keep the address and API key it shows at the end.

CLI

If you used the one-line installer, start GPROXY with the command it printed. Otherwise run the command below. Then open the console in your browser and sign in. A new instance prints its administrator password and API key once, so save them.

gproxy serve --data-dir ./data
http://127.0.0.1:8787/console/

Containers

Images on Docker Hub (gproxy2/gproxy), GitHub, GitLab and CNB registries for amd64, arm64 and riscv64. Stable versions use vX.Y.Z tags; beta is staging and development snapshots are nightly.

docker run -d --name gproxy -p 127.0.0.1:8787:8787 -v gproxy-data:/app/data gproxy2/gproxy:latest
Container guide →

Hosted platforms

Deploy to Cloudflare Workers, Netlify or Vercel without a local toolchain, with D1, libSQL or PostgreSQL behind it.

Hosted deployments →

Build from source

A plain cargo build produces the CLI; the Application and the headless edition each have a short recipe.

cargo build --release -p gproxy
Building from source →

Verify what you downloaded

Every release attaches a SHA256SUMS file and a signed manifest.json. The CLI and Application verify the same Ed25519 signature before self-updating; signing keys live only in the release pipeline.

Installed? Continue with Quick start. Upgrading from v3? Read the migration guide.