Upgrade Guide

Applicare follows semantic versioning. Minor and patch upgrades are backward compatible; agents one minor version behind the server continue to report normally, so you can upgrade the server first and roll agents afterward.

Before you upgrade#

• Read the release notes for your target version.
• Take a configuration snapshot — see Backup & Recovery.
• Confirm you have at least 20% free disk for the migration.

Upgrade the server#

Helm:

helm repo update
helm upgrade applicare applicare/applicare --reuse-values

Native package:

sudo dnf upgrade applicare-server
sudo applicare-setup --migrate
sudo systemctl restart applicare

Schema migrations run automatically on first start and are logged to /var/log/applicare/migrate.log.

Upgrade agents#

Agents self-update when auto-upgrade is enabled (default). To pin or trigger manually:

applicare-agent upgrade            # single host
helm upgrade applicare-agent applicare/agent   # DaemonSet

Rollback#

If a health check fails, roll the server back with helm rollback applicare (or reinstall the previous package) and restore the pre-upgrade config snapshot. Ingested data is preserved across rollbacks within the same major version.