Back up and restore
For the person who set up Stuga.
By default, Stuga backs up daily at 03:00 in its configured time zone and keeps the newest three backups, plus the latest backup from before an upgrade. Backups stay on the same Mac. Stuga also backs up before an update changes its data, and marks that backup Before upgrading from the version you had.
Check or take a backup
Section titled “Check or take a backup”- Open Settings → This node → Backups.
- Check Scheduled backup, Repeat and At for the schedule and time. The page shows the time zone.
- Set Keep to choose how many backups to keep.
- Choose Back up now to take one now.
Stuga pauses while backing up; open documents reconnect afterwards. The page lists backups and any failure. A failed scheduled backup also notifies the people who look after Stuga.
Keep another copy
Section titled “Keep another copy”The folder appears under Backups. Copy backups to another disk so a failure of the Mac’s disk doesn’t take them too. Time Machine keeps copies when it is on.
Restore on a Mac
Section titled “Restore on a Mac”Restoring replaces all current Stuga data. Nobody can use Stuga during the restore. Take a fresh backup first if you want to keep the current state. To go back to the version you had before an update, restore the backup marked Before upgrading from.
-
Open Settings → This node → Backups, choose Restore… beside the backup you want, and choose Copy.
-
Open Terminal, in Applications → Utilities, paste the command and press Return. It looks like this:
Terminal window sudo "/Library/Application Support/Stuga/current/bin/stuga" restore 2026-09-16T101500ZIf asked, enter the password you use to approve changes on your Mac. Nothing appears as you type.
-
Type the backup’s name when asked.
Stuga stops, the backup is restored, and Stuga starts again, on the version the backup came from. For a backup from an earlier version, the command downloads that version first. The Stuga menu says Restoring a backup… meanwhile. If the command can’t restore that backup, it says why and changes nothing.
If Settings doesn’t open,
sudo "/Library/Application Support/Stuga/current/bin/stuga" list in Terminal lists the backups.
Put the name of the one you want in place of the example above.
Open Stuga and check your documents. The restore keeps the data it replaced separately, but the restored Stuga resumes its usual deletion of old trash and expired history.
- Move a workspace to another computer — move one workspace or all of Stuga.
- When something goes wrong — deal with a failed start or connection.
More detail: Go back to an earlier version on GitHub · Mac operator commands on GitHub.