Sairo

A self-hosted, S3-compatible object storage browser. Browse, search, and manage any S3-compatible storage from your browser. Built for petabyte scale.

Works with AWS S3, MinIO, Ceph, Wasabi, Cloudflare R2, Backblaze B2, Leaseweb, NetApp StorageGRID, and any S3-compatible endpoint.

Demo

Screenshots

Features

• Object Browser — Navigate buckets and prefixes with virtual scrolling for 100K+ objects
• Instant Search — SQLite-indexed search across all objects by filename
• File Preview — Images, text, CSV, JSON, PDF, Parquet/ORC/Avro schemas, and binary hex
• Upload & Download — Multipart upload with progress tracking, drag-and-drop support
• Storage Dashboard — Visual breakdown by prefix with growth trend charts and cost estimates
• Cost Intelligence — Per-folder cost breakdown with provider comparison. AWS pricing fetched live; others from community data
• Version Management — Browse, restore, delete, and purge individual object versions
• Version Scanner — Background scan reveals hidden delete markers and ghost objects
• Bucket Management — Versioning, lifecycle rules, CORS, ACLs, policies, tagging, object lock
• Object Operations — Copy, move, rename, delete (files and folders, bulk)
• Share Links — Password-protected share links with configurable expiration
• Multi-Endpoint — Connect multiple S3 backends and manage all from one dashboard
• Audit Log — Full activity trail with filtering by action, user, and bucket
• User Management — Role-based access control (admin / viewer) with per-bucket permissions
• Two-Factor Auth — TOTP-based 2FA with QR setup and recovery codes
• OAuth & LDAP — Google, GitHub OAuth and LDAP authentication
• AI-Powered Analysis (MCP) — Connect Claude, Cursor, or any MCP client to ask natural language questions about your storage. 26 tools for analytics, cost optimization, pipeline health, and more
• Petabyte-Scale Performance — Folder listings in 0.05ms on 500K+ objects. Pre-computed prefix hierarchies, 64MB SQLite page cache, 256MB memory-mapped I/O, async FTS rebuilds
• Dark Mode — Full dark/light theme with system preference detection
• Keyboard Shortcuts — 30+ shortcuts for power users
• Single Container — No dependencies. No microservices. Just docker run and go.

Quick Start

Docker

docker run -d --name sairo -p 8000:8000 \
  -e S3_ENDPOINT=https://your-s3-endpoint.com \
  -e S3_ACCESS_KEY=your-access-key \
  -e S3_SECRET_KEY=your-secret-key \
  -e ADMIN_PASS=choose-a-strong-password \
  -e JWT_SECRET=$(openssl rand -hex 32) \
  -v sairo-data:/data \
  stephenjr002/sairo

Then open http://localhost:8000 and log in with admin / your chosen password.

Docker Compose

cp .env.example .env
# Edit .env with your S3 credentials
docker compose up -d

Helm

helm install sairo oci://registry-1.docker.io/stephenjr002/sairo-helm \
  --namespace sairo \
  --create-namespace \
  --set s3.endpoint=https://your-s3-endpoint.com \
  --set s3.accessKey=your-access-key \
  --set s3.secretKey=your-secret-key \
  --set auth.adminPass=choose-a-strong-password \
  --set auth.jwtSecret=$(openssl rand -hex 32)

AI Storage Intelligence (MCP)

Sairo includes an optional MCP (Model Context Protocol) server that lets AI assistants analyze your storage infrastructure. Deploy it as a sidecar alongside Sairo.

# Uncomment sairo-mcp in docker-compose.yml, then:
docker compose up -d

Connect Claude Desktop, Cursor, or any MCP-compatible client and ask:

• "What buckets do I have?" — Lists all buckets with sizes and status
• "What's eating all the space?" — Storage breakdown by folder with percentages
• "How much is this costing me?" — Cost estimates across AWS, R2, B2, Wasabi, Leaseweb
• "Find all parquet files" — Full-text search across millions of objects
• "Are there any duplicates?" — Finds redundant files with estimated savings
• "Is my data pipeline still running?" — Freshness check per folder
• "Run a full storage audit" — 7-step analysis with actionable recommendations

26 tools, 4 guided workflows, zero configuration. The AI picks the right tools automatically.

Performance

Benchmarked on production data (557K objects, 167 TB, NetApp StorageGRID):

Scaling: Tested up to 2M objects per bucket. Designed for petabyte scale with instant folder navigation at any dataset size.

Environment Variables

Tech Stack

Pricing Data Sources

Cost estimates in the Storage Dashboard use a hybrid approach:

Why not all live? Only AWS exposes a pricing API. Cloudflare R2, Backblaze B2, Wasabi, Leaseweb, and other S3-compatible providers do not have programmatic pricing endpoints. Their prices are published on marketing pages and change infrequently (<1x/year).

Community help wanted: If you know of a provider that now offers a pricing API, or if any of the static prices are outdated, please open an issue or submit a PR updating backend/pricing.py. We want cost estimates to be accurate and will integrate better data sources as they become available.

Supported providers: AWS S3, Cloudflare R2, Backblaze B2, Wasabi, Leaseweb, DigitalOcean Spaces, Hetzner, Scaleway, OVHcloud, iDrive e2, Storj, MinIO, Ceph.