Customermates: Managing Your Installation

Updating your installation

From your deployment root:

chmod +x scripts/selfhost-update.sh
./scripts/selfhost-update.sh

The update script is expected to:

After every update, verify service health with docker compose ps.

Use the restart helper when configuration changes require a clean restart:

chmod +x scripts/selfhost-restart.sh
./scripts/selfhost-restart.sh

This script should restart the stack safely and print health and log pointers.

Most operational issues can be diagnosed with container logs:

docker compose logs -f app
docker compose logs -f postgres

Useful checks:

docker compose ps to inspect service state and health
docker compose config to validate merged Compose configuration
docker compose exec app sh to inspect runtime environment inside the app container

Daily operations you may use:

docker compose up -d
docker compose down
docker compose pull
docker compose build --no-cache app
docker compose restart app

Use targeted restarts (docker compose restart app) when only the application changed.

For production deployments, maintain a backup and restore routine:

If you are just getting started, go back to the Self-Hosting quick setup.

Logs and troubleshooting basics

Most operational issues can be diagnosed with container logs:

docker compose logs -f app
docker compose logs -f postgres

Useful checks:

docker compose ps to inspect service state and health

docker compose config to validate merged Compose configuration

docker compose exec app sh to inspect runtime environment inside the app container