Skip to content

Storage and Backups

Nick Hamze edited this page Sep 8, 2026 · 2 revisions

Storage and Backups

Site metadata and snapshots use IndexedDB on the OpenStation origin, partitioned by installation/user. Working files use a per-site OPFS directory on the runtime origin, within the browser's storage partition. Each running site holds a Web Lock to prevent another tab from editing the same files.

New sites mount storage after installation. Existing sites mount storage before boot using Playground’s existing-files mode, which reconstructs runtime-owned SQLite integration without downloading a fresh WordPress tree or rerunning the setup recipe. Missing saved files stop startup with an error instead of silently reinstalling WordPress. Saved runtimes flush after PHP requests, explicit operations, periodic saves, and before a normal native-window close. Minimized windows keep running. Force teardown or closing the browser cannot await an asynchronous final save.

Browser storage can be cleared or evicted. Checkpoints in the same browser are not external backups. Download or explicitly back up anything important. Recess does not automatically upload or synchronize sites.

OpenStation's desktop file storage must be configured as private on the host, including its documented nginx deny rule where applicable. Recess uses the existing authenticated upload/download API; it does not put snapshots in the Media Library.

Instant sessions and safety status

Instant sessions use https://playground.wordpress.net/remote.html with its matching client and do not use OPFS or require the Recess storage companion. This is an explicit quick-start dependency on the public Playground service, not a pinned first-party mirror. The UI labels these sessions temporary. Their manually saved and automatic checkpoints still use the OpenStation-origin IndexedDB catalog.

Automatic checkpoints are retained until explicitly deleted. They are created before Recess-controlled package installation and checkpoint restoration, and a failed checkpoint prevents the operation. Nothing automatically uploads these checkpoints.

The safety strip shows browser save status and the last successful OpenStation backup. Browser ZIP downloads are recorded as requests, not verified external backups: the browser cannot prove the user retained the downloaded file. Package-only exports do not count as site backups.

Clone this wiki locally