Skip to content

Backup and restore

In the admin: General, then Backup. See the Settings reference.

Stackyard’s whole configuration is one JSON file. Export and Import are under General.

Downloads your configuration as dashboard-apps.json, containing apps, folders, widgets, badges, and settings. Use it as a backup, or to move an install to another machine.

Reads a file produced by Export. Stackyard shows how many items will be added, updated and deleted, and asks you to confirm before writing anything. A file matching your current configuration changes nothing and says so.

The config file lives on /data. Uploaded icons and stored wallpapers live on /icons. An export covers the config only, so back up both volumes to capture uploaded files.

If the config fails to parse, or parses with the wrong shape, Stackyard copies it to apps.json.corrupt-<timestamp> and starts empty rather than overwriting the broken one. Each distinct breakage keeps its own backup.

If your dashboard is empty after a restart, look for an apps.json.corrupt-* file before making changes.

To import a gethomepage or Dashy config instead, see Migrating from another dashboard.