Skip to content
Liwan

Installing Liwan Using Docker

To run Liwan with Docker:

Terminal window
docker run -d --name liwan \
  -p 127.0.0.1:9042:9042 \
  -v liwan-data:/data \
  -e LIWAN_BASE_URL=https://a.example.com \
  ghcr.io/explodingcamera/liwan:1.6

The important parts are:

  • -p 127.0.0.1:9042:9042 binds Liwan to localhost on port 9042.
  • -v liwan-data:/data stores Liwan data in a persistent Docker volume.
  • LIWAN_BASE_URL should match the public URL where your Liwan instance will be reachable.

This starts Liwan on 127.0.0.1:9042 with persistent data in the liwan-data Docker volume. For a public instance, you will usually add a reverse proxy for HTTPS and public routing. See Setting up a Reverse Proxy and the Configuration Reference.

To view the logs (and find the setup URL), you can run:

liwan
docker logs liwan
It looks like you're running Liwan for the first time!
You can get started by visiting: http://localhost:9042/setup?t=1234567890
To see all available commands, run `liwan --help`