Server maintenance
See also: Client maintenance.
Common maintenance tasks for a containerised MultiTaction Canvus Server. For a Windows standalone installation, see Operating Canvus Server on Windows.
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 container messages from the Canvus application
sudo podman logs -f canvus-combined
# Stream logs from the database
sudo podman logs -f canvus-postgres
# View last 100 lines
sudo podman logs --tail 100 canvus-combined
The Canvus Server log files are written to /canvus-data/logs/server/ on the host. Administrators can also read them in the web UI. See Audit log and server logs.
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, run /opt/canvus/bin/mt-canvus-server --help to see available CLI commands. The program folder is not on the PATH, so use the full path.
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 (for example with Let's Encrypt), reload them without restarting the server:
sudo podman exec canvus-combined /opt/canvus/bin/mt-canvus-server --reload-certs