Sync overview

Vetroscope keeps everything on your computer unless you turn sync on. When you do, your tracked time, tags, goals, events, notes, alerts, categories, settings, and app customizations stay the same on every computer you use. Private details are encrypted on your computer before anything is uploaded.

Where your data syncs through

Sync needs a server in the middle that your computers send their changes to. In Vetroscope these are called sync targets, and there are two kinds:

Vetroscope Cloud — our servers. Nothing for you to run; part of Vetroscope Pro. See Vetroscope Cloud.
Home Sync — a server you run yourself, at home or on your own hardware, so your data never leaves your network. Included with a license. See Home Sync.

Add one in Settings → Sync → Add sync target. You can use both at once. Each one has a power button: turn it off to stop syncing with that server (this also stops a sync that’s in progress), and back on to start again.

Vetroscope Cloud also powers the web dashboard, so you can see your data from a browser or phone. Home Sync doesn’t.

Your data is protected with sign-in recovery by default: it’s encrypted before upload, and you unlock it on a new computer just by signing in. For extra protection, turn on end-to-end encryption, which uses an encryption key that only you have.

When syncing happens

On its own: when Vetroscope opens, then every 15 seconds while it’s running. Changes you make — tags, notes, events, alerts, goals, categories, disputed idle time, and so on — reach your other computers within a few seconds. Click Sync Now in Settings → Sync to sync right away.

A large sync, like the first one on a new computer, shows a progress bar with how much is done and, while uploading, about how long is left.

Reading the status

Under each server’s name you’ll see Synced and how long ago, Syncing… while it’s working, or Ready to sync before the first sync. When something needs your attention, a label appears next to the name:

Off — the power button is off.
Unreachable — this computer can’t reach the server right now.
Error — hover it to see why. If it says Click to reconnect, click it to sign in again.
Update Vetroscope — the server needs a newer version of the app.
Update Home Sync — your Home Sync server needs updating.
Update available — there’s a newer Home Sync server version. Click it to see what’s new.

The info button shows more about the server, including whether it uses Sign-in recovery or is End-to-end encrypted.

The ⋯ menu has tools for when something goes wrong:

Reconnect — sign in again, if your sign-in has expired.
Force full resync — check everything against the server again.
Force resync icons — the same, for app icons only.
Wipe and re-sync — delete the server’s copy and upload this computer’s data again.
Wipe cloud data (on Home Sync, Wipe server data) — delete the server’s copy and turn sync off.
Remove target (Home Sync only) — disconnect this computer from the server.

None of these touch the data on your computer. If a status won’t go away, see Sync troubleshooting.