Upgrade

Self-Hosted

Update Command

ch-ui update

The updater downloads the latest release asset for your OS and architecture, verifies the checksum when available, and replaces the running binary on disk.

What Happens

1. CH-UI fetches the latest release from GitHub.
2. The correct binary for your platform is downloaded.
3. Checksum verification runs automatically if checksums are available.
4. The current binary is replaced in place.

After updating, restart the server to pick up the new version:

ch-ui server restart

Verify the update:

ch-ui version

Docker

Pull the latest image and recreate the container:

docker pull ghcr.io/caioricciuti/ch-ui:latest
docker stop ch-ui-server
docker rm ch-ui-server
docker run -d \
  --name ch-ui-server \
  --restart unless-stopped \
  -p 3488:3488 \
  -v ch-ui-data:/app/data \
  ghcr.io/caioricciuti/ch-ui:latest

Connector Updates

If you run connectors on remote hosts, update them to match the server version:

ch-ui update        # on each connector host
ch-ui service restart  # if running as a service

Cloud

The CH-UI Cloud server is updated automatically — no action needed on your end.

Connectors still need manual updates. The ch-ui connect binary on your ClickHouse hosts should be kept up to date:

ch-ui update

Then restart the connector:

ch-ui service restart
# or, if running manually:
ch-ui connect --url wss://your-org.ch-ui.com/connect --key cht_your_token

You can verify the connector version matches the server by checking the connection status in the Console.