Skip to main content
The Community edition is free and open source. It ships as the ghcr.io/onecli/onecli image with a Docker Compose file that bundles PostgreSQL, so a single command brings up the full stack.

​
Quick start

The fastest path is the installer: 
curl -fsSL https://onecli.sh/install | sh
Or run it manually: 
git clone https://github.com/onecli/onecli.git
cd onecli
docker compose -f docker/docker-compose.yml up -d --wait
Open http://localhost:10254, create an agent, add your secrets, and point your agent’s HTTP proxy at localhost:10255.
By default the instance runs in single-user mode: no login screen, no .env required. Anyone who can reach port 10254 has admin access, so the compose file binds to 127.0.0.1. To enable multi-user mode with Google OAuth, set NEXTAUTH_SECRET and the Google credentials.

​
Pin a version

The compose file tracks latest by default. Pin a release with the ONECLI_VERSION variable: 
ONECLI_VERSION=v1.40.0 docker compose -f docker/docker-compose.yml up -d --wait
Releases are listed on GitHub.

​
Upgrading

git pull
docker compose -f docker/docker-compose.yml pull
docker compose -f docker/docker-compose.yml up -d --wait
Database migrations run automatically when the new container starts. Back up PostgreSQL first: docker compose -f docker/docker-compose.yml exec postgres pg_dump -U onecli onecli > backup.sql.

​
What’s different from Enterprise

The Community edition includes the full dashboard and the community app integrations, connected with your own OAuth credentials. Premium app integrations, granular per-agent access policies, and the boot-time organization API key are part of the Enterprise edition, available under a commercial agreement — contact us.

​
Next steps