← Docs

Linux

Install and run Gold Lapel on any Linux distribution.

Install

The install script detects your architecture (x86_64 or aarch64) and libc (glibc or musl) automatically. Pre-built binaries are available for all four combinations.

curl -fsSL https://goldlapel.com/install.sh | sh

Or install with Homebrew:

brew install goldlapel
goldlapel --version

The binary installs to /usr/local/bin/goldlapel.

Run as a systemd service

For production, run Gold Lapel as a systemd service so it starts on boot and restarts on failure.

/etc/systemd/system/goldlapel.service 
[Unit]
Description=Gold Lapel — self-optimizing Postgres proxy
After=network.target postgresql.service

[Service]
ExecStart=/usr/local/bin/goldlapel --upstream 'postgresql://goldlapel:password@localhost:5432/mydb'
Restart=always
RestartSec=3
User=goldlapel
Group=goldlapel
Environment=RUST_LOG=info

[Install]
WantedBy=multi-user.target
sudo systemctl enable --now goldlapel

Check that it's running:

sudo systemctl status goldlapel

Next steps

  • Commands — subcommands, connection modes, TLS, replicas, failover
  • Configuration — dozens of settings — flags, env vars, TOML, and wrapper keys