macOS

Install and run Gold Lapel on macOS — Apple Silicon and Intel.

Install with Homebrew

brew install goldlapel

Homebrew picks the right binary for your architecture (Apple Silicon or Intel) automatically. To update later:

brew upgrade goldlapel

Install without Homebrew

The install script also detects your architecture and installs to /usr/local/bin/goldlapel.

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

goldlapel --version

Start the proxy

Run directly from the terminal:

goldlapel --upstream 'postgresql://goldlapel:password@localhost:5432/mydb'

Run as a launchd service

For persistent operation, create a launchd plist so Gold Lapel starts on boot and restarts on failure.

com.goldlapel.proxy.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.goldlapel.proxy</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/goldlapel</string>
        <string>--config</string>
        <string>/etc/goldlapel/goldlapel.toml</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

sudo cp com.goldlapel.proxy.plist /Library/LaunchDaemons/
sudo launchctl load /Library/LaunchDaemons/com.goldlapel.proxy.plist

Next steps

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