Skip to content

Repository files navigation

Next.js 16 TypeScript Tailwind CSS MIT License

S3 Compass

A web-based S3 file manager. Browse, upload, download, preview, and manage files across multiple S3-compatible storage services — no login required.

Think Redis Insight, but for S3.

Features

  • Multi-connection — manage multiple S3-compatible services (AWS, Hetzner, MinIO, R2, etc.)
  • File browser — navigate folders, upload (drag & drop), download, delete, create folders
  • File preview — images, video, audio, PDF, JSON (tree view), CSV (sortable table), text, code
  • Presigned URL sharing — generate shareable links with custom expiry (1h to 7d)
  • Storage analytics — bucket size, file type breakdown, largest files, growth trends
  • Favorites & recent files — bookmark paths and track recently accessed files
  • Health checks — auto-ping connections every 60s with status indicators
  • Export/import — encrypted backup & restore of connection configs
  • Keyboard navigation — arrows, Enter, Delete, / to search, Space to select
  • Column sorting & pagination — sort by name/size/date, load more for large buckets
  • Dark/light mode — system-aware theme toggle

Getting Started

git clone https://github.com/C0RE1312/s3-compass.git
cd s3-compass
pnpm install
pnpm dev

Open http://localhost:3000 and add your first S3 connection.

S3-Compatible Services

When adding a connection, set your endpoint, region, and enable Force Path Style (required for most non-AWS services).

Field Hetzner MinIO
Endpoint https://fsn1.your-objectstorage.com http://localhost:9000
Region fsn1 us-east-1
Force Path Style true true

Security

S3 Compass is designed for internal/local use with no built-in authentication. Credentials are stored in a local SQLite database (data/s3compass.db). Do not expose to the public internet without adding your own auth layer.

Contributing

Contributions are welcome! Please open an issue first to discuss what you'd like to change.

License

MIT

About

Web-based local S3 file manager. Browse, upload, preview, and manage files across multiple S3-compatible services. Built with Next.js, shadcn/ui, and SQLite.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages