DevProxy

DevProxy is a macOS-native developer tool that watches Docker Compose projects, assigns local vanity domains like acme-crm.test, serves local DNS, and proxies HTTP and HTTPS traffic to the correct published localhost port.

What It Does

• macOS only
• Built as a Go CLI with an optional menu bar runtime
• Designed for local Docker Desktop workflows

Documentation

• Getting started
• CLI reference
• Configuration
• Troubleshooting
• Architecture

Prerequisites

• macOS
• Docker Desktop or a compatible local Docker Engine socket
• mkcert installed and trusted for local HTTPS
• sudo access for install and uninstall flows

Install

Install via Homebrew:

brew install aaronflorey/tap/devproxy

Or, if you use bin:

bin install https://github.com/aaronflorey/devproxy

If you do not have bin installed, see aaronflorey/bin.

Install the daemon and optional menu bar app:

sudo devproxy install --with-menubar

Configuration

DevProxy reads configuration from environment variables and an optional YAML config file passed with --config.

Minimal example:

domain_suffix: test
root_services:
  - app
  - web
serving:
  managed_suffix: test
  redirect_http_to_https: false

Usage

Install the daemon and optional menu bar app:

sudo devproxy install --with-menubar

Inspect runtime health:

devproxy status
devproxy doctor
devproxy routes

Remove the installed services:

sudo devproxy uninstall --with-menubar --yes

Development

Build from source:

mise install
mise run fmt
mise run test
mise run build

Useful commands:

go run . status
go run . doctor
go run . routes

Contributing

See CONTRIBUTING.md.

Security

See SECURITY.md.