One-Line Install (Recommended)
Install lbctl and deploy LangBot with one command: Python set up automatically, native or Docker deployment, start on boot, one-command upgrades.
This is the recommended way to self-host LangBot on Windows, macOS and Linux. Prefer not to self-host? Use LangBot Cloud.
Install
macOS / Linux:
curl -fsSL https://langbot.app/install.sh | bashWindows (PowerShell):
irm https://langbot.app/install.ps1 | iexThe script installs lbctl, the LangBot CLI, which then deploys LangBot:
- Native (default, recommended): Python is downloaded and set up automatically — no prerequisites, no admin rights.
- Docker: offered when Docker is available, or force it with
--driver docker. - LangBot starts automatically on boot/login, and a "LangBot is ready" panel is shown at the end.
Then open http://localhost:5300 and create the administrator account.
Common options
# Pick the driver and port and skip every prompt
curl -fsSL https://langbot.app/install.sh | bash -s -- --driver native --port 5300 --yesOn Windows pass options as environment variables, e.g. $env:LANGBOT_DRIVER="docker", $env:LANGBOT_PORT="5300", $env:LANGBOT_YES="1".
Everyday management
lbctl status # status and versions
lbctl logs # logs
lbctl doctor # diagnose problems
lbctl stop / start / restart
lbctl upgrade --yes # upgrade to the latest LangBot
lbctl update # update lbctl itself
lbctl autostart disable # stop starting on boot
lbctl uninstall --yes # uninstall (data kept by default)
lbctl list # all local instanceslbctl follows your system language (English or Chinese); override it with --lang en / --lang zh-Hans.
For the full guide (upgrade details, adopting an existing Docker deployment, multiple instances, managing resources from the command line) see Manage LangBot with lbctl.
Other deployment options
- Docker Compose — when you manage containers yourself
- Kubernetes
- BT Panel and 1Panel
- Package manager (uvx) — for development and quick experiments, not recommended for everyday use
Data Collection Policy
Optional telemetry, execution chains, collected data and opt-out controls
Manage LangBot with lbctl
Install, upgrade, start/stop, read logs, diagnose, configure autostart, run multiple instances and uninstall LangBot with lbctl, and bring existing Docker Compose deployments under lbctl.
