Maintenance

Common maintenance tasks for a containerised Canvus server.

Start, stop, and restart

# Start all services
sudo podman-compose up -d

# Stop all services
sudo podman-compose stop

# Restart all services
sudo podman-compose restart

# Restart only the Canvus application (not the database)
sudo podman restart canvus-combined

View logs

# Stream live logs from the Canvus application
sudo podman-compose logs -f canvus-combined

# Stream logs from the database
sudo podman-compose logs -f canvus-postgres

# View last 100 lines
sudo podman logs --tail 100 canvus-combined

Logs are also written to /canvus-data/logs/ on the host.

Check status

sudo podman-compose ps

Both canvus-postgres and canvus-combined should be listed as running.

Open a shell inside the container

Useful for debugging or running server CLI commands:

sudo podman exec -it canvus-combined bash

From inside the container you can run mt-canvus-server --help to see available CLI commands.

Update to a new version

sudo podman-compose pull
sudo podman-compose down
sudo podman-compose up -d

See updating for full details.

Remove unused images

After updating, old images remain on disk. Remove them to free space:

sudo podman image prune

Reload TLS certificates

If you have renewed your TLS certificates (e.g. via Let's Encrypt) without restarting the server, you can reload them without a full restart:

sudo podman exec canvus-combined mt-canvus-server --reload-certs