PanelicaDocs
panelica.com
Docs / Updates & Support / System Updates

System Updates

Panelica 1.0.375 Verified 2026-07-24 Updates & Support

Panelica updates itself and every service it manages, nginx, Apache, the PHP versions, PostgreSQL, MySQL, Redis, BIND, the mail stack, the panel backend and frontend, from a central catalog, with each update backed up and health-checked so a bad one rolls back automatically. This page explains the update screen, the two channels, and why an update is safe to run on a live server.

Panel locationSupport → System Updateshttps://YOUR-SERVER-IP:8443/support/updates (ROOT / ADMIN)
 System Updates
Services
28
Up to date
25
Updates
3
Channel
stable
update panelica-server 1.0.374 → 1.0.375 · self-update

The screen

The page has two tabs, Service Updates (the main screen) and Auto-Updates (per-service automatic-update status). The main tab lists every installed service grouped by category, Web, Database, Runtime, Email, FTP, DNS, Web Apps and Panel, each row showing the installed version and, if one is available, the new version with an Update button. Four cards summarize the fleet: total services, up-to-date, updates available, and categories. Categories with a pending update open expanded by default.

Every service row also offers Reinstall (re-apply the current version, useful to repair a service) and, where a previous version was backed up, Rollback (with the backup's expiry date shown).

Updating

You can update one service at a time or all at once.

  • Single update: click Update on a row. A dialog shows the current and new version, the download size, a security badge, the changelog and any breaking-changes warning, then applies it with a progress bar.
  • Update All: one click runs every available update in sequence. It is a real sequencer, it applies each package, stops immediately if one fails (the failed package is already rolled back, the rest are skipped), and always does the panel backend last, because updating the backend restarts it.
Updating the panel itself is handled specially. When the update is panelica-server, the panel is about to restart under you. Panelica shows a full-screen reconnect overlay, waits for the backend to come back, and keeps your session, so a self-update doesn't log you out or look like a crash. (The panel's nginx and the CLI reconnect the same way but through the in-dialog progress rather than a full-screen overlay.) A panel-frontend update reloads the browser once afterward so you get the new interface.

Stable and beta channels

Updates come on two channels, set on the System Updates settings tab:

  • Stable, released versions only, the default.
  • Beta, released plus testing versions, for trying updates early.

The channel is stored server-side (in the panel database), not just in your browser, so it survives a browser reset or a move to another machine, and changing it takes effect immediately.

Beta channel self-heal: if a server is running a beta build of the panel but its channel setting was never persisted, Panelica detects this on the next update check and puts it back on beta automatically, so a beta tester never silently drops back to stable and loses the rest of a beta rollout. This is a guarded, one-time correction that never overrides a channel you deliberately chose.

Dependency gating

Some updates require a newer panel backend first (for example, a database engine upgrade that needs the backend's new upgrade logic). Panelica enforces this with a minimum-panel-version gate on the offending package: an older backend simply doesn't see that update until it has updated the panel itself. So the order is enforced technically, not left to you to remember, update the panel, and the dependent update appears on the next check.

Why an update is safe on a live server

Every update runs through Panelica's hardened apply path, which is built to survive a crash, a power loss or a bad package without leaving the server broken. For each update it:

  • Verifies the download against a SHA-256 checksum before touching anything.
  • Backs up first, the current files, the relevant configs, and, for a panel-backend update, a snapshot of the panel database (because the new backend will run migrations). If the snapshot can't be taken, the update aborts while the old, working version is still running.
  • Writes a journal of each step, so if the process is interrupted, the next boot knows exactly where it was and finishes or reverses it.
  • Extracts atomically (a rename, never a half-written binary) and re-checks the files.
  • Health-checks after restart, and if the service doesn't come back healthy, it rolls back to the backup automatically. For the panel backend, the new version is only marked "successful" once it has actually started and run its migrations, so a bricked update can never masquerade as a good one.
  • Handles database engines specially, a MySQL or PostgreSQL major upgrade has extra pre-checks and its own rollback strategy, because those can't be undone as casually as a file swap.
Rollback windows expire. A rollback restores a service from a backup slot kept for a limited time (shown as the expiry date on the Rollback button). Roll back within that window; older slots are rotated out to save disk. Rollback is available from this page and from the recovery console when the panel is down.

Auto-Updates

The Auto-Updates tab shows each service's automatic-update status, its last result (success, failed or rolled back), current version and last check. The global automatic-update settings, whether auto-updates run at all and the maintenance window they run in, live on the Panel Settings → System Updates tab; this tab links you there. You can also trigger a per-service Check Now or Update Now from here.

Access

System Updates is available to ROOT and ADMIN (other roles can't reach it). It is not behind a license feature, keeping the platform patched is core. Everything you do here goes through the same audited, checksum-verified, auto-rollback apply path described above.

Panelica Documentation · Written and verified against the live panel. · Last verified 2026-07-24 on Panelica 1.0.375