Skip to content

Health ​

The Health tab is the inbox's actionable punch list — failed sync jobs, broken source URLs, and items that need user input.

What Shows Up ​

The Health view collects:

  • Failed sync jobs — items that couldn't push, pull, or upload an attachment
  • Broken source URLs — saved links that no longer resolve (404, DNS failure)
  • Missing fields — items captured without required metadata (rare; usually from older builds)
  • Stale items — past the threshold from Settings → Tasks
  • Quota warnings — when the vault is approaching its storage limit

If everything is healthy, the tab is empty.

Failed Sync Jobs ​

Each failed job shows:

  • The item the job was for (with a link)
  • The error message
  • A Retry button
  • The number of retry attempts so far

Retrying re-queues the job. If retries keep failing, the underlying cause is likely:

SymptomLikely causeFix
"Network unreachable"OfflineReconnect
"Unauthorized"Sign-in expiredSign in again
"Quota exceeded"Vault at storage limitFree up space or upgrade
"Blob hash mismatch"Rare corruptionPush from the source device

Broken Source URLs ​

Saved links that fail an integrity check (HEAD request returns 4xx / 5xx, or DNS fails) get a broken-URL chip.

Per-item actions:

  • Open archived copy (if available)
  • Update URL (paste a new link)
  • Convert to note (capture whatever you remember as content)
  • Archive (acknowledge it's gone)

Missing Fields ​

Older builds occasionally captured items with required fields missing. The Health tab surfaces them and offers a one-click form to fill in missing metadata.

You won't see these on a fresh install — they're a migration artifact.

Stale Items ​

Items older than the Stale Inbox Days setting show a stale chip. Stale doesn't break anything; it's a periodic reminder.

The default is 30 days; tune it in Settings → Tasks.

Quota Warnings ​

Approaching the vault's storage limit triggers a warning row. From there:

  • See storage breakdown by category — same as Settings → Vault
  • Find largest items (helpful for attachment cleanup)
  • Empty Trash and clear orphaned attachments

When to Visit ​

  • After a long offline stretch (sync jobs to retry)
  • After a sign-in or device-rotation event (auth-related failures)
  • Periodically (stale items, quota)

A quick weekly pass through Health keeps things tidy.

See Also ​

Released under the GNU GPL v3.0.