All docs

Troubleshooting

Use these checks when setup, previews, sharing, publishing, or agent-backed roots do not behave as expected.

Storage

  • Confirm the root credentials still have access to the bucket or path.
  • Check endpoint, region, bucket name, and optional prefix for cloud roots.
  • For agent roots, confirm the agent is online in Storage.

Preview and download

  • If browser previews fail on object storage, check CORS on the root.
  • If Office previews fail, conversion support may be unavailable on the backend.
  • If version history is empty, versioning may have been enabled after the file was created.

Publishing

  • Publishing works on Markdown notes backed by cloud storage roots.
  • For custom domains, copy the URL from the Published pages list after refreshing status.
  • For DNS problems, use Custom domains.

Agent

Agent logs are usually the quickest path when a root is offline or a file path is rejected.

  • On Linux, check systemctl --user status filestor-agent.
  • Review logs with journalctl --user -u filestor-agent -f.
  • Confirm the file path is inside the agent allowed roots.