Help

Troubleshooting

Fix common start, auth, path, and background issues.

Quick fixes

SymptomWhat to try
Port already in useSettings → Port (e.g. 8081), then restart
No root folderSettings → Root Folder; grant files access first
Access revokedRe-enable Files access and re-pick the root
No IP / offlineReconnect Wi‑Fi or hotspot; open Home to refresh
401UnauthorizedWrong password, or client not sending Basic auth
403ForbiddenRead-only user writing, or user without a home
404Not foundPath wrong relative to that user’s root
Server dies in backgroundEnable Run in background + notifications
Files + disabledSelect a root folder first

Browser downloads

  • Wrong password, folder path, or expired one-time link → Rejected page.
  • Download did not start → use “Click here if the download does not start” on the success page (links are short-lived and single-use).
  • Opening /favicon.ico never downloads your storage file named the same way — that URL is the public site icon.
  • Root / in a browser is only the “use a WebDAV client” portal — not a file browser. Use a file URL for the sign-in → one-time download flow.
Browser root page
Root / — use a WebDAV client
Browser download states
Login, download, refresh, wrong password, no access

Log filters

Use Get / Put / Delete / Errors chips to isolate traffic while a desktop client syncs.

GET filter
GET
PUT filter
PUT
DELETE filter
DELETE
Errors filter
Errors

Still stuck?

Confirm the phone and client share the same private network, the server is RUNNING, and you are using the credentials of an account that can see that path (admin vs user home).