All tutorials
Getting startedSelf-hosting

Install OtoDock with Docker Compose

From an empty server to your own agent platform: one compose file, one env file, and your admin account — in about ten minutes.

6 min read

OtoDock self-hosts as a single Docker Compose stack: the server and dashboard, PostgreSQL, and live document preview. You need a Linux host with Docker installed — a small VM or a home server is plenty to start.

1. Fetch the compose file

$ mkdir -p /opt/otodock && cd /opt/otodock
$ curl -fsSLO https://raw.githubusercontent.com/OtoDock/oto-dock/main/docker-compose.yml

2. Set a database password

$ echo "POSTGRES_PASSWORD=$(openssl rand -hex 24)" > .env

That one variable is enough for a first boot. Every other setting has a sensible default you can change later.

3. Start the stack

$ docker compose up -d

The first start pulls the images and initializes the database. When it settles, open http://your-server:8400 and create your admin account — the first account registered becomes the administrator.

Where to next

  • Create your first agent — see the next tutorial in this series.
  • The install guide covers reverse proxies, HTTPS, backups, and upgrades in depth.

Put your agents to work

Self-host free up to 5 users — running in minutes.

Get started