📁 Filesystem Backend

The fastest backend — sub-millisecond read latency from local disk. Mount Docker volumes, NFS shares, or EFS for shared access. Built-in path traversal protection.

Configuration

local-images:
  type: filesystem
  basePath: ./images           # relative or absolute path

Use Cases

Development

Point to a local test images directory. Zero setup, instant feedback.

Docker

Mount a volume: -v /data/images:/app/images:ro

NFS / EFS

Mount a network filesystem for multi-server shared access.

Performance

BackendFirst-Read LatencyScalability
Filesystem< 1ms (SSD)Single server
Amazon S320–100msUnlimited
Google Cloud Storage20–80msUnlimited

Security

Path traversal attacks are blocked — ../../etc/passwd is rejected. All paths must resolve within the configured basePath.

Connect Your Storage in Minutes

Free tier — no credit card required.

Get Started Free Read the Docs