Daemon commands
The daemon is a long-running local HTTPS proxy that runs on your machine and transparently routes outbound API calls through the Passport Proxy. It lets external clients like curl, scripts, and SDKs use Passport without any code changes — configure your HTTP client to use http://127.0.0.1:8081 as its proxy, and the daemon handles the rest.
On macOS, the daemon auto-starts on sign-in using launchd. On Linux, start it manually with passport daemon start.
passport daemon install
Install the daemon and configure it to start automatically on login. On macOS, this installs LaunchAgents and sets HTTPS_PROXY so external clients pick it up without manual export commands.
passport setup installs and starts the daemon automatically. Use this command only if you need to reinstall after running passport daemon uninstall.
Usage
Options
Port for the daemon to listen on.
Append the shell-init snippet to an rcfile as a fallback for interactive shells.
Skip the env LaunchAgent and rely entirely on the rcfile. Advanced use only.
Absolute path to the passport binary. Defaults to the current binary.
passport daemon uninstall
Remove the LaunchAgents and unset the launchctl environment variables.
Usage
Options
Remove the sentinel-bracketed block from the specified rcfile.
passport daemon start
Start the daemon. By default, the daemon runs as a detached background process.
Usage
Options
Port for the daemon to listen on.
Run in the current process without detaching.
Skip the outer TLS hostname check on the upstream handshake. The certificate chain is still validated.
passport daemon stop
Stop the running daemon.
Usage
passport daemon restart
Stop and restart the daemon.
Usage
Options
Port for the daemon to listen on after restart.
passport daemon status
Report the daemon’s running state, certificate expiration, and upstream reachability. For more information, see Check the daemon.
Usage
Options
Emit raw JSON instead of formatted text.
passport daemon logs
Tail the daemon’s log file.
Usage
Options
Keep streaming new lines as they’re written.
Number of most recent lines to print first.