> ## Documentation Index
> Fetch the complete documentation index at: https://onecli.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy Community Edition

> Run the free, open source OneCLI edition with Docker Compose: full dashboard, bundled PostgreSQL, one command.

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:

```bash theme={null}
curl -fsSL https://onecli.sh/install | sh
```

Or run it manually:

```bash theme={null}
git clone https://github.com/onecli/onecli.git
cd onecli
docker compose -f docker/docker-compose.yml up -d --wait
```

Open [http://localhost:10254](http://localhost:10254), create an agent, add your secrets, and point your agent's HTTP proxy at `localhost:10255`.

<Info>
  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](/self-hosting/configuration#authentication) with Google OAuth, set `NEXTAUTH_SECRET` and the Google credentials.
</Info>

## Pin a version

The compose file tracks `latest` by default. Pin a release with the `ONECLI_VERSION` variable:

```bash theme={null}
ONECLI_VERSION=v1.40.0 docker compose -f docker/docker-compose.yml up -d --wait
```

Releases are listed on [GitHub](https://github.com/onecli/onecli/releases).

## Upgrading

```bash theme={null}
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](/self-hosting/configuration#app-integrations). Premium app integrations, granular per-agent access policies, and the boot-time [organization API key](/self-hosting/enterprise/all-in-one) are part of the [Enterprise edition](/self-hosting/overview#choose-an-edition), available under a commercial agreement — [contact us](https://onecli.cal.com/jonathan/30min).

## Next steps

* Review the [configuration reference](/self-hosting/configuration)
* [Connect the CLI and agents](/self-hosting/connect-agents)
* Add [rules](/guides/rules) to control what your agents can do