Restore a deleted project and roll back an upgrade
Delete a test project in Borago Board, bring it back from the recycle bin, then learn how restore points roll the whole board back after a bad update.
Borago Board keeps two safety nets for your data. The recycle bin holds deleted projects for 30 days. Restore points are whole copies of the board, taken before an update may change it. This tutorial practises the first on a throwaway project, so the real thing is familiar when you need it, and then walks through the second.
You will build
A test project deleted and restored with its tasks, and a clear picture of when a restore point exists and what restoring one does.
You need
- The desktop app.
- A project you can delete safely. Create one called
bin-testwith two small tasks, see Creating a project.
Steps
1. Delete the test project
Press Edit project on bin-test, then Delete project at the bottom left. Type the project's name in the box and press Delete project.
What happens. The dialog says the project and its tasks go to the recycle bin for 30 days and that its container stops. The project leaves the board. Nothing is destroyed yet, and the deletion syncs to your other devices.
2. Find it in the recycle bin
Open Settings, then Data & recovery. Under Recycle bin, find bin-test with its task count and the time it has left.
What happens. Every deleted project sits here until its time runs out. The bin is also reachable from a browser and the phone, since deletions sync.
3. Restore it
Press Restore beside bin-test. A dialog titled with the project's name asks whether to switch to it. Press Switch to it.
What happens. The project, the tasks deleted with it, and their comments and attachments come back. A task that was already deleted before the project was does not return. If a live project has taken the same name meanwhile, the restored one is renamed with (restored) after it.
4. Start its container again
On the board, press Start container in the project controls.
What happens. The delete stopped the container and the restore does not start it, so start it yourself. The project's files and settings are as they were, and the tasks can run again.
5. Look at the restore points
Open Settings, then Data & recovery, and scroll to Restore points.
What happens. The desktop copies the whole board file before a new version is allowed to change it. That happens when a database upgrade is pending and when the app's version has changed, but never for an empty board. The last 2 copies are kept, and older ones are removed on their own. Each row says why it was taken, such as Saved before updating or Saved before a database upgrade with the version, then its time and size. On a fresh install the section is not shown until the first copy exists.
6. Know how a rollback goes, before you need one
Only after a bad update, press Restore on the copy from before it. The dialog Restore this copy of your board? says everything will be replaced. Press Restart and restore.
What happens. The restore is applied at the next start, never while the board is open, so the app restarts itself to do it. Until then the section shows A restore is queued and will be applied the next time the app starts with Cancel it. The board you had is saved first, as a point named Saved before you restored an earlier copy, so the rollback can itself be undone.
What a rollback does and does not touch
| Rolled back | Not rolled back |
|---|---|
| Every project, task and comment on this computer's board | The app itself. The newer version stays installed |
| The journal of earlier credential values, copied with each point | Project files on disk and inside containers |
| Containers, images, volumes and networks |
Anything created after the copy was taken is gone. Restore points are local files on this computer, not cloud backups, and the cloud keeps the live data and offers no earlier copy to restore. Delete on a point frees its space and cannot be undone.
Check it worked
bin-test is back on the board with both tasks, and its container is running.
Where to go next
To remove the test project for good, delete it again, then press Delete beside it in the recycle bin and confirm twice. On the desktop that also removes its containers, networks, images and the volumes its compose file declares. A volume the agent created on its own may stay. Settings, then Docker, then Docker disk usage counts it in the volumes total without naming it.
Related: Recovering things, Recovery, Container management, Uninstalling