Installing liwan Using Docker Compose
-
Create a
docker-compose.ymlfiledocker-compose.yml services:liwan:image: ghcr.io/explodingcamera/liwan:1.8container_name: liwanports:# Bind liwan to localhost on port 9042- "127.0.0.1:9042:9042"volumes:# Store liwan data in a persistent Docker volume- liwan-data:/data# See https://liwan.dev/reference/configuration for all configuration optionsenvironment:# Set the public URL where your liwan instance will be reachable- LIWAN_BASE_URL=https://a.example.com# Trust the reverse proxy connecting through this isolated deployment- LIWAN_TRUSTED_PROXIES=*volumes:liwan-data: -
Start liwan
Terminal window docker compose up -dFor a public instance, add a reverse proxy for HTTPS and public routing. The
*value is appropriate here because liwan is bound to host loopback and the Compose network is isolated. Use the actual proxy address or network instead if other untrusted services can connect to liwan. See the trusted proxy guidance. -
Find the setup URL
Check the logs and open the setup URL to create your first user, project, and entity:
liwan docker compose logs liwanIt looks like you're running liwan for the first time!You can get started by visiting: http://localhost:9042/setup?t=1234567890To see all available commands, run `liwan --help`