Pulse/docs/operations/AUTO_UPDATE.md

🔄 Automatic Updates

Manage Pulse auto-updates on host-mode installations.

Note

: Docker/Kubernetes users should manage updates via their orchestrator.

⚙️ Components

File	Purpose
pulse-update.timer	Daily check (02:00 + jitter).
pulse-update.service	Runs the update script.
pulse-auto-update.sh	Fetches release & restarts Pulse.

🚀 Enable/Disable

Via UI (Recommended)

Settings → System → Updates → Automatic Updates.

Via CLI

# Enable
sudo jq '.autoUpdateEnabled=true' /var/lib/pulse/system.json > tmp && sudo mv tmp /var/lib/pulse/system.json
sudo systemctl enable --now pulse-update.timer

# Disable
sudo jq '.autoUpdateEnabled=false' /var/lib/pulse/system.json > tmp && sudo mv tmp /var/lib/pulse/system.json
sudo systemctl disable --now pulse-update.timer

🧪 Manual Run

Test the update process:

sudo systemctl start pulse-update.service
journalctl -u pulse-update -f

🔍 Observability

• History: curl -s http://localhost:7655/api/updates/history | jq
• Logs: /var/log/pulse/update-*.log

↩️ Rollback

If an update fails:

1. Check logs: /var/log/pulse/update-YYYYMMDDHHMMSS.log.
2. Revert manually:

   sudo /opt/pulse/install.sh --version v4.30.0
   

   Or use the Rollback button in the UI if available.