Vaultime
Docs / Your data

Backups

Vaultime backs up your library and history to a folder by itself every day. A sync folder keeps those backups on your other PCs too. Cloud backup to a server you or a friend run is an optional extra, encrypted on your PC before anything leaves it.

On this page
  1. Local backups
  2. Sync folder
  3. What a backup holds
  4. Restoring
  5. Cloud backup
  6. Turning it on
  7. Signing up
  8. How it works
  9. Space and rotation
  10. What the server sees

Local backups #

Local backups are plain folders you can keep anywhere. Settings, Local backups holds everything about them.

Back up automatically
On from the start. Vaultime makes a backup once a day and when it quits, unless the last one is less than an hour old or nothing changed since, and keeps the newest seven. Backups you save by hand are never deleted.
Automatic backups go to
The backups folder inside the data folder to begin with. Change picks another one. A folder on another drive keeps your history safe when the drive fails. Several PCs may share one folder, each keeps and deletes only its own backups. To keep your backups on your other PCs, use a sync folder.
Save a backup
Makes a backup right now, into a folder you pick.
Restore from a backup
Shows what is inside a backup, and only Replace with this backup replaces your history with it.

History lists the latest backups with their time.

Sync folder #

A sync folder is a folder that a sync service or a NAS keeps the same on every PC, such as one in Dropbox, Google Drive, OneDrive or Syncthing. Settings, Sync folder holds it.

Folder
Choose picks the folder. Vaultime keeps a folder named Vaultime in it, with a folder for each PC, and copies a backup of this PC there right away. Choose the same folder on each of your PCs. A PC that played nothing yet copies nothing, so a new install can restore first. Stop leaves the backups in the folder and keeps new ones on this PC.

Each PC copies every automatic backup there and keeps its newest three. The database goes as it is, and every image is stored once, so your sync service uploads an unchanged cover only once. A PC only ever writes its own folder. The backup made when Vaultime quits goes there at the next start, so a folder that is away never holds up quitting. A folder that is away, like a NAS that is off, gets the newest backup once it is back. While automatic backups are off, no new backup of this PC reaches the folder.

Below the folder, every PC with a backup there has a row:

  • Merge brings in another PC's sessions the first time, with the same dialog as any merge. After that its newer backups come in by themselves within the hour, as from the cloud.
  • Restore replaces this PC's history with that backup, after the same preview as a local restore. On a new install it sets the PC up again, see Several PCs.

A backup the sync service is still bringing in fails its check and waits for the next look.

What a backup holds #

A backup holds your games, every session with its full log, the ledger, your settings and the cached artwork.

Some things belong to the PC they were set on:

  • The look, the window size, the folder automatic backups go to and the sync folder are in the backup, but a restore keeps this PC's own. On a PC where nobody ever changed the look, like a new one, the restore brings the look of the backup: mode, ground tone, accent, where the background comes from, and its dim and blur. A picture of your own stays out of backups.
  • The background picture and the key that signs the PC's ledger are left out of backups.

The ledger notes every restore.

Restoring #

A restore takes in only the sessions that pass their check with the keys this PC trusts, or that this PC vouched for before in the same state. A session of this PC that was still running when the backup was made is closed as Recovered at its last saved time, counting at most five minutes past the last note the ledger holds. A session another PC was still running stays open as that PC recorded it, see Several PCs. A backup of a PC this one has never seen is taken at its word, like a first merge.

On a fresh install with no history of its own, restoring a backup of another PC makes this PC continue as that PC. The restore preview asks first, with a switch that is on by default. Turn it off and this PC stays the PC it is, and the backup's sessions come in as another PC's, as on a PC with history of its own. See Several PCs.

Vaultime refuses a backup that is damaged or holds database parts it never writes.

Cloud backup #

Turning it on #

Cloud backup is off on a new install, and the menu has no Cloud page. Turn on Use cloud backup under Settings, Cloud backup, and the Cloud page joins the menu. Turned off, Vaultime neither signs in nor uploads backups, and it does not read a saved sign-in from the keyring. A PC that is signed in keeps cloud backup until you sign out.

Signing up #

On the Cloud page, type the address of the server under Your server and pick Connect. Vaultime checks that a Vaultime server answers there, remembers it for this PC and says whether it takes new accounts and whether they need a sign-up code. Create an account asks for your email, a password and a backup passphrase, and for the sign-up code on a server that has one. Whoever runs the server gives you the code. The password signs you in. The passphrase encrypts your backups and is at least 12 characters long.

How it works #

  • Backups are encrypted on your PC with your passphrase before they are uploaded, so the server only stores data it cannot read.
  • Once unlocked, a key made from the passphrase stays in your system's keychain with your sign-in, so daily backups run without asking. The passphrase itself is not kept.
  • Back up every day uploads a backup of this PC once a day while you are signed in, whatever your other PCs upload. Back up now uploads one right away.
  • Artwork is stored once per account, so unchanged covers are not uploaded again.
  • Restore on a backup works like a local restore, after you confirm.
  • Registered PCs lists every PC that signed in with your account, by the name you gave it. A PC whose name this PC cannot open shows as Vaultime Windows Desktop or Vaultime Linux Desktop: one without a backup passphrase or with another one, one on a version or a server before 0.7, and every PC while this one has no passphrase yet. Remove frees the place of a PC you no longer use, and its backups stay. A PC still in use registers again when it next signs in.

Space and rotation #

Every account on a server gets the same space, by default 1 GiB for backups and artwork, and keeps up to 30 backups. Whoever runs the server can change the limits. Space used on the Cloud page shows how much is taken. When there are 30 backups or the space is full, a new backup replaces the oldest ones once it is safely stored. The newest backup of each PC always stays, so your other PCs can merge it. The server refuses a backup larger than 512 MiB or one that does not fit the space beside the newest backups of your other PCs. It also refuses a new backup of a PC less than 15 minutes after that PC's last one. The limits are there so that no account can fill the server.

What the server sees #

Your email address, the platform and app version of each PC you back up from and when it registered and last signed in, and for each backup when it was made, how large it is and how many games, sessions and images it holds. It also sees the encrypted size of each image, and the public keys each PC signs its ledger with, so a merge from the cloud can check them. The name you gave a PC goes with its registration and its backups, encrypted with your passphrase. The server cannot read your games, sessions, artwork or PC names. The privacy policy has the details.

Edit this page on GitHub