Online Update

RoleAdmin Only

PlatformWeb

VersionNo version record

Administrators can independently check, install, or roll back Web interface and compatible backend service versions.

Scope

Online Update manages Web interface assets and backend services separately, each with its own version, validation, switching, and rollback state.

• Admin only: Regular users do not see the entry and cannot install or roll back a version.
• Web only: The iOS, Android, and car clients do not provide this entry.
• Web interface updates: Supported by the domestic fnOS FPK and enabled Docker deployments.
• Backend service updates: Supported only by the domestic fnOS FPK. Installation and rollback require the fnOS unified gateway.
• Not a full upgrade: Online updates do not replace the supervisor, database schema, FFmpeg, FPK, Docker image, or mobile App. Install a full FPK when the schema or supervisor must change.

Entry

After signing in as an administrator on the Web client, open Profile -> Online Update.

The page has Frontend and Backend Service tabs. An unavailable capability is shown as disabled. The international FPK and local development environments do not provide online installation.

Backend runtime status remains readable through a direct port, but check, install, and rollback require the fnOS unified gateway and an fnOS administrator identity.

Frontend Update

The page shows:

• Bundled Version: The Web interface included with the current FPK or Docker image.
• Current Version: The interface currently served to the browser, identified as bundled or online.
• Available Version: The latest Web interface version reported by the update source.
• Download Size: The size of the available update package.
• Backend Compatibility: Whether the available interface version supports the current Rust backend.

An incompatible Web interface version cannot be installed.

Check and Install

1. Select Check for Updates to load the latest version and compatibility status.
2. When the version is compatible, select Install Update and confirm.
3. After installation, select Reload Interface so the browser loads the new Web assets.

Installation only switches Web interface assets. It does not clear libraries, accounts, playback progress, or the database. If installation fails, the current valid version remains active.

Rollback

When a rollback version is available, the page shows Roll Back to vX.X.X. Confirming it rolls back only the Web interface assets; reload the interface afterward.

The Web interface bundled with the distribution remains available as the baseline. If online assets are unavailable or incompatible, the system can continue using the bundled interface. A Web interface rollback is not a rollback of the backend service, database, FPK, or Docker image.

Backend Service Update

The fixed supervisor packaged in the FPK manages backend workers. It owns the public port and fnOS gateway socket, while the Rust API worker listens only on a loopback port.

The page displays the active backend version, available version, download size, supervisor version, runtime state, rollback target, and automatic fallback state.

Check and Install

1. Open the application through the fnOS unified gateway and select Backend Service.
2. Select Check for Updates. Only a signed manifest from the fixed HTTPS release directory is accepted.
3. Installation validates architecture, size, SHA-256, Ed25519 signature, supervisor protocol version, and database schema compatibility.
4. The candidate starts on a separate loopback port and receives new traffic only after three consecutive readiness checks succeed.

Download, startup, or readiness failure leaves the current worker active. Installed online workers are revalidated from disk before every start.

Automatic Fallback and Rollback

If an online worker fails twice within the 60-second crash window, the supervisor switches to the previous worker that declares compatibility with the current schema, or to the bundled worker when necessary. The supervisor remains available and serves recovery status while workers are unavailable.

A release that disables automatic rollback is never switched to an older binary automatically. Manual rollback also validates the target as a candidate before traffic switches.

Backend online updates never run database migrations. Install a full FPK to add or change the database schema.

Common Messages

• Frontend online updates are not enabled for this distribution: Continue upgrading through the FPK, Docker image, or official installation package.
• Backend incompatible: The available Web interface requires a different backend version and cannot be installed.
• Install or rollback failed: The current valid interface remains active. Retry later or continue using the current version.
• fnOS unified gateway administrator required: A direct-port session can inspect backend status only. Open the application from the fnOS desktop entry.
• Candidate validation failed: Signature, integrity, compatibility, or readiness validation failed. The active backend remains unchanged.
• Backend service is recovering: The supervisor is still running and is restarting the worker or selecting a compatible fallback.