Skip to main content

Greyproxy Quickstart

Installation​

Homebrew (macOS)​

brew tap greyhavenhq/tap
brew install greyproxy

Build from Source​

git clone https://github.com/greyhavenhq/greyproxy.git
cd greyproxy
go build ./cmd/greyproxy

Via Greywall​

If you're using Greywall, you can install and start greyproxy automatically:

greywall setup

Install as a Service​

Install the binary to ~/.local/bin/ and register it as a systemd user service:

./greyproxy install

This copies the binary, registers a systemd user service, and starts it automatically. The dashboard will be available at http://localhost:43080.

To remove everything:

greyproxy uninstall

Run in Foreground​

To run the server directly without installing as a service:

greyproxy serve

Or with a custom configuration file:

greyproxy serve -C greyproxy.yml

Service Management​

Once installed, manage the service with:

greyproxy service status
greyproxy service start
greyproxy service stop
greyproxy service restart

Access the Dashboard​

Once running, open http://localhost:43080 in your browser to access the dashboard.

The dashboard shows:

  • Real-time traffic overview
  • Pending requests awaiting approval/denial
  • Rule management
  • Request logs

Default Ports​

ServicePort
Dashboard/API43080
HTTP Proxy43051
SOCKS5 Proxy43052
DNS Proxy43053

Next Steps​