DocsGetting startedInstall with Docker

Install with Docker

Get vuzon running with Docker Compose in a couple of minutes — two files, two variables, one container.

Quick install

Grab the Compose file and the environment template from the main branch:

terminal

$ mkdir vuzon && cd vuzon
$ curl -fsSL -O https://raw.githubusercontent.com/KN990x/vuzon/main/docker-compose.yml \
    -O https://raw.githubusercontent.com/KN990x/vuzon/main/.env.example
$ cp .env.example .env

Fill in DOMAIN and CF_API_TOKEN in .env — those two are the whole file — and start the panel:

terminal

$ docker compose pull && docker compose up -d

.env ships with empty values on purpose — vuzon will not start until you fill in DOMAIN and CF_API_TOKEN. There is no session secret to generate by hand and no password to write down in plain text.

Open the panel

Open http://localhost:8001 (or http://<server-ip>:<port> on your LAN). The first visit asks you to choose a username and a password — see Initial setup.

To publish the panel on another host port, set VUZON_PORT in .env. Inside the container Compose sets PORT=8001 — you usually omit PORT in .env for Docker.

If something fails

Startup errors name the exact variable to fix:

terminal

$ docker compose logs -f vuzon

More cases in Troubleshooting.