Skip to main content

Updating the Daployi Web System

The websystem does have a update button in the UI, if a new version is detected it will prompt to install a new version. if this failes or you want to update manually you can follow the steps below. see bellow

if you used the install utility to install you can re run that command to update the web system. see here

Manual steps

  1. Backup: Export your database and persistent volumes according to your ops policy.
  2. Review release notes for breaking changes.
  3. Pull new images:
docker compose pull
  1. Restart to apply the update with minimal downtime:
docker compose up -d
  1. Verify: Check the web UI version, run a smoke test (sign in, list devices, open a device page).

Troubleshooting

  • If the UI doesn’t start, check logs (service name may differ):
docker compose logs -f web
  • Schema migrations run automatically; if blocked, ensure the database is reachable and credentials are valid.
  • Rollback: Pin the previous image tag in your compose file and redeploy:
# example snippet in compose.yaml
# services:
#   web:
#     image: ghcr.io/your-org/daployi-web:1.2.3

docker compose up -d

Best practices

  • Test upgrades in staging before production.
  • Pin images by version tags for controlled rollouts.