Storage roots
A storage root is a top-level location Filestor can browse. A root can point to object storage such as R2 or S3, or to a machine running the Filestor agent.
Cloud storage
- Open Storage.
- Choose the provider, then enter the bucket, endpoint, credentials, and optional prefix.
- Use a scoped access key with only the bucket permissions Filestor needs.
- Use the CORS check when you want browser previews and direct downloads to work.
Agent storage
- Create an agent enrollment token in Storage - Agent.
- Run the installer on the machine that has the files.
- Attach an allowed path as a root after the agent shows as online.
The Linux agent guide walks through the full installer path: Install the Filestor agent on Linux.
Checks
CORS
If previews or browser downloads fail for object storage, check the root's CORS status. Agent-backed roots do not use bucket CORS.
Versioning
S3-compatible roots can expose native object version history. R2 and agent-backed roots may report versioning as unsupported. In S3, suspended versioning keeps existing versions but stops creating new ones.
Root paths keep provider prefixes such as s3://, r2://, or agent:// internally, but Explorer shows them as normal files and folders.