15e96458e2
- Refactor specialized docs for conciseness and clarity - Rename files to UPPER_CASE.md convention - Verify accuracy against codebase - Fix broken links
47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
# 🔄 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
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
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:
|
|
```bash
|
|
sudo /opt/pulse/install.sh --version v4.30.0
|
|
```
|
|
Or use the **Rollback** button in the UI if available.
|