KaziDocs

Troubleshooting

Fix common Kazi OS problems: the app won't load, files are missing, sync is stuck, email won't send or arrive, install problems and storage warnings.

The app won't load or looks broken

  1. Reload the page (Ctrl+R / ⌘R).
  2. If you see App update available, click it to load the latest version.
  3. Do a hard reload: Ctrl+Shift+R (⌘⇧R on Mac).
  4. Try another browser to see if the problem is browser-specific.

Warning: Don't clear "site data" for kazios.app unless your files are synced or backed up. That deletes files stored only on this device.

My files are missing

  • Check you're signed in to the same account and using the same browser and device as before. Unsynced files live only where they were made.
  • Look in Recent Files and use the File Manager search (or Ctrl+K).
  • In private/incognito windows, browsers delete everything when you close the window. Use a normal window for real work.
  • Restore from a backup if you have one.

Sync is stuck

  • Make sure you're online and signed in.
  • Wait a minute: sync runs in the background and retries automatically.
  • Re-sync a file from its ⋮ menu → Re-Sync File to Cloud.

Email doesn't send

  • Check the address is valid (it turns red if not).
  • Attachments must fit in the 25 MB limit. See Writing email.
  • "Sending limit reached": wait an hour and try again.
  • Offline messages are queued and sent when you reconnect.

Email doesn't arrive

  • Ask the sender to check the address is spelled yourhandle@kazios.app.
  • Look in Spam.
  • Refresh the inbox (Check Mail & Sync Now in the Message menu).
  • Mail apps on your phone need an app password.

"Install" isn't offered

  • Chrome, Edge and Brave show the install icon in the address bar; Safari uses Share → Add to Home Screen; Firefox on desktop doesn't support installing web apps (you can still use Kazi in the browser).
  • If Kazi is already installed, the option is hidden.

Storage is almost full

Browsers limit how much each site can store. Delete files you don't need (empty the Trash), export large PDFs you're done with, and turn on sync so you can safely remove local copies.

Still stuck?

Email support@kazios.app with your handle, device, browser and a screenshot.