Skip to content
Vetroscope Docs

Sync troubleshooting

Find the message you’re seeing below. Each one explains why it happens and how to fix it.

“Unreachable”

Section titled ““Unreachable””

Cause: this computer can’t reach the sync server right now. Either it’s offline, or — for Home Sync, almost always — you’re away from home without your VPN on, the computer running the server is asleep, or the server has stopped. Nothing is lost in the meantime.

Fix: check your internet or VPN (for example Tailscale) connection. For Home Sync, check the server is running — opening http://<server-address>:4437/health in a browser should show a reply. Sync tries again on its own; click Sync Now to try straight away. Only use Reconnect in the ⋯ menu if the message stays after the server is reachable again.

“Authentication expired — use Reconnect in the target menu”

Section titled ““Authentication expired — use Reconnect in the target menu””

Cause: your sign-in to that server has expired — after a long time offline, a password change, or if this computer was removed from your account. Fix: click the red Error label, or choose Reconnect from the ⋯ menu, and sign in again. For Home Sync, use your Home Sync password, not your Vetroscope password. You don’t have to set anything up again; your settings and encryption key stay as they are.

“Encryption key required to sync”

Section titled ““Encryption key required to sync””

Cause: this computer doesn’t have your encryption key yet — usually because it’s new, or you just signed in. Fix: click Unlock and enter the key. Lost it? Read Your encryption key before doing anything else.

“Pro subscription required” / “License required”

Section titled ““Pro subscription required” / “License required””

Cause: your plan doesn’t include this kind of sync. Vetroscope Cloud needs Pro; Home Sync needs a license (or Pro). Fix: check your plan in Settings → Account. If you just purchased, sign out and back in so the app picks it up.

“Vetroscope is out of date — open About → Check for updates”

Section titled ““Vetroscope is out of date — open About → Check for updates””

Cause: the server needs a newer version of the Vetroscope app than this computer has. Fix: update the app (Settings → About → Check for Updates). If the label says Update Home Sync instead, it’s your Home Sync server that needs updating — on the computer running it, run docker compose pull && docker compose up -d.

A computer shows up twice, or old ones are still listed

Section titled “A computer shows up twice, or old ones are still listed”

Cause: reinstalling Vetroscope, or moving to a new computer, added it to your account again. Fix: go to Settings → Account → Connected devices and remove the old one. Its tracked time stays in your history; only the extra listing goes.

Your computers don’t match

Section titled “Your computers don’t match”

Give them a minute first, and click Sync Now on both. If some days are still missing or counted twice, try these from the ⋯ menu:

  • Force full resync — checks everything against the server again. Safe to use; it can take a while if you have a long history.
  • Wipe and re-sync — deletes the server’s copy and uploads this computer’s data again in its place. Only use it on the computer you’re sure has the right history; it asks you to confirm first. The data on this computer isn’t touched.

If only app icons look wrong, try Force resync icons first — it’s much quicker.

Problems with the Home Sync server itself

Section titled “Problems with the Home Sync server itself”

A lost setup code, a lost admin password, “database is locked”, a full disk, and server updates are covered in the server’s own troubleshooting guide on GitHub. To reset an admin password, run docker exec vetroscope-home-sync vhs-cli reset-password --email <you> --password <new>.