pitchfork proxy
- Usage:
pitchfork proxy <SUBCOMMAND> - Effect: read-only
Manage the pitchfork reverse proxy
The reverse proxy routes requests from stable URLs to the daemon's actual listening port. Every daemon with a port gets a hostname automatically, built from the daemon, worktree and project names plus the configured TLD:
https://api.myproject.localhost
https://api.fix-login.myproject.localhost
Slugs are the older mechanism and still work. They are defined in the global config (~/.config/pitchfork/config.toml) under [slugs], each mapping to a project directory and daemon name, and are resolved before hostnames.
Enable the proxy in your pitchfork.toml or settings:
[settings.proxy]
enable = true
Subcommands:
setup Point this machine's DNS, trust store and ports at the proxy
doctor Check everything a proxy URL needs in order to work
trust Install the proxy's TLS certificate into the system trust store
untrust Remove the proxy's TLS certificate from the system trust store
add Add a slug mapping to the global config (legacy)
remove Remove a slug mapping from the global config (legacy)
status Show hostnames and registered slugs with their current state
Flags
-h --help— Print help
