Operations¶
Unraid OS update maintenance¶
Before the update¶
- Back up the Unraid boot device configuration.
- Check and apply plugin updates.
- Stop Docker and, if applicable, VM services.
- Stop the array cleanly and confirm it is unmounted.
- Review the target release and confirm the rollback path.
Apply a stable release¶
- Open the OS update interface and select the stable branch.
- Download and apply the target release.
- Wait for the completion message before restarting.
- Reboot and monitor the boot.
Post-update validation¶
Host
- Management interface reachable.
- Array starts cleanly.
- Filesystems mount without errors.
- Hardware drivers load.
Service
- Docker engine starts.
- Dependent containers start in order.
- Reverse-proxied names resolve.
- Metrics and health probes recover.
Hardware consideration
After a platform-level change, verify boot priority and hardware-specific driver modules before restoring the full application workload.
Change record¶
Record for each maintenance window: previous version, target version, backup location, start time, outcome, observed issues, and whether rollback was required.
Backup and recovery¶
| Asset | Protection | Recovery use |
|---|---|---|
| AdGuard Home | Baseline config stored on Unraid | Rebuild DNS service quickly |
| Caddy | Config backup stored on Unraid | Restore reverse-proxy routing |
| Unraid boot device | Configuration archive before updates | Restore host settings and boot config |
| Proxmox workloads | Proxmox Backup Server under evaluation | Test host and workload recovery |
Maturity
Configuration backups and documented rollback are in place. Proxmox Backup Server is being tested and is not represented as a completed production backup platform.
Rollback paths¶
Management interface available
- Open the OS update page and select the automatically preserved previous release.
- Restore and reboot.
- Perform post-rollback validation.
Host not bootable
- Power down safely.
- Mount the boot device on another system.
- Restore the previous release files or a known-good backup.
- Reinstall the device and validate boot and array state.
Recovery priorities¶
- Host access and storage integrity.
- DNS and private network access.
- Reverse proxying and certificates.
- Monitoring, before lower-priority applications.
- Application containers, in dependency order.
Operational checklists¶
After a service change¶
- [ ] Configuration validates.
- [ ] Service reloads or restarts cleanly.
- [ ] FQDN resolves from a LAN and a mesh client.
- [ ] Certificate is valid for the requested name.
- [ ] Upstream responds through Caddy.
- [ ] Prometheus target is healthy.
- [ ] Grafana shows current data.
- [ ] Health script completes without false recovery.
During an incident¶
See the incident-response checklist.