Mullgate
Reference

Commands

Command surfaces referenced throughout the Mullgate documentation.

The documentation repeatedly anchors itself to the following CLI help contract:

  • mullgate --help
  • mullgate setup --help
  • mullgate proxy --help
  • mullgate proxy start --help
  • mullgate proxy logs --help
  • mullgate proxy relay --help
  • mullgate config --help
  • mullgate version --help
  • mullgate completions --help

Core workflow commands

commandkey flagspurpose
mullgate setup--non-interactive, --location, --exposure-modecreate or update canonical config and derived runtime artifacts
mullgate proxy access--mode, --access-mode, --base-domain, --route-bind-ip, --unsafe-public-empty-passwordinspect or update exposure posture, access mode, host planning, DNS guidance, selector examples, and direct-IP entrypoints
mullgate proxy export--regions, --guided, selector flagslist region groups or generate client-ready proxy inventories in published-routes mode
mullgate proxy relay listselector flags such as --country, --owner, --providerinspect relay candidates that match a policy
mullgate proxy relay probe--country, --countlatency-probe likely relay candidates
mullgate proxy relay recommend--country, --count, --applypreview or pin an exact relay choice
mullgate proxy relay verify--routeverify a configured route across the published proxy protocols
mullgate proxy validate--refreshrefresh saved validation metadata and config-derived artifacts
mullgate proxy start--dry-runrender and validate artifacts, then optionally launch the runtime
mullgate proxy stopnonestop the saved Docker runtime bundle without rerendering artifacts
mullgate proxy restartnonestop the current runtime bundle, rerender artifacts, and start it again
mullgate proxy statusnoneinspect live runtime state
mullgate proxy logs--tail, --followread the saved Docker Compose logs for the current runtime bundle
mullgate proxy doctornonediagnose routing, hostname, and runtime failures
mullgate proxy autostartenable, disable, statusmanage Linux user-service startup, including linger-backed reboot startup
mullgate config pathnoneprint config, state, cache, and runtime paths
mullgate config shownoneprint the saved canonical config
mullgate config get<key>read one saved config value
mullgate config set<key> <value>update one saved config value
mullgate versionnoneprint CLI version plus support metadata
mullgate completions <shell>bash, zsh, fishgenerate shell completion scripts

Invocation forms

Mullgate is documented in two operator-facing forms:

  1. installed mullgate command
  2. packed release asset or extracted standalone binary

How the commands fit together

A practical workflow usually looks like this:

  1. mullgate setup
  2. mullgate proxy access
  3. if you want a proxy inventory file, mullgate proxy export --regions
  4. if you want a proxy inventory file, mullgate proxy export --guided
  5. mullgate proxy relay list
  6. mullgate proxy relay probe
  7. mullgate proxy relay recommend
  8. mullgate proxy access
  9. mullgate proxy validate --refresh
  10. mullgate proxy start --dry-run
  11. mullgate proxy start
  12. mullgate proxy status
  13. mullgate proxy logs --tail 50
  14. mullgate proxy doctor
  15. mullgate proxy restart when you need a stop-plus-rerender cycle later

If you switch to inline-selector, skip mullgate proxy export and use mullgate proxy access to inspect the shared listener and selector examples. For the supported selector families and guaranteed URL shape, see Inline Selector Reference.

Reference practice

When in doubt, prefer the live CLI help output as the source of truth for flags, defaults, and command wording.

On this page