Skip to main content

Installation

The fastest install is two commands on the machine you want to serve:

pip install cptr
cptr run

That path (including uvx cptr@latest run if you prefer uv) is covered step by step in the quickstart. This section covers everything else:

You wantGo to
Install with pip or uv on the machine itselfQuickstart
Run in a container (compose, named volumes, project mounts)Docker
Install on a Windows machineWindows
Install on a host with no internet accessAir-gapped
Upgrade an existing installUpdating

Requirements

  • Python 3.10 or newer (not needed for Docker)
  • macOS, Linux, or Windows
  • A browser, on the same machine or any other device

Optional feature groups install as pip extras: cptr[mcp] for MCP tool servers, cptr[pam] for PAM auth, or cptr[all] for everything. The Docker image already includes all of them.

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.