Skip to main content

CLI

The CLI has exactly one command:

cptr run
FlagDefaultBehavior
--host127.0.0.1Bind address. The default is loopback-only; use --host 0.0.0.0 to accept connections from other devices on your network.
--port8000Listen port. Also exported to the process as CPTR_PORT.
--headlessoffDon't auto-open a browser on start. Use for servers, systemd units, and containers.
--reloadoffAuto-restart on code changes. Development only.

On first run (while no user account exists yet), the server prints a one-time setup URL of the form http://<host>:<port>/?token=<64-hex>. Opening it creates the first user as admin. The token stops working as soon as a user exists.

Install extras

pip install cptr needs Python 3.10+. Optional feature groups:

ExtraAdds
cptr[mcp]MCP tool server support
cptr[pam]PAM authentication (Linux system users)
cptr[agents]Coding-agent extras
cptr[docs]Document-handling extras
cptr[all]Everything above

No install at all:

uvx cptr@latest run

What the CLI doesn't have

  • No other subcommands. There is no cptr user, cptr migrate, or similar; database migrations run automatically on startup.
  • No TLS flags. HTTPS comes from a reverse proxy or tunnel in front of Computer, not from the CLI.
  • No --workers. It runs as a single process.
  • No password-reset command. Admins reset passwords in the UI; if you're locked out of the only admin account, see Troubleshooting for the recovery procedure.
This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.