safebucket /safebucket

On-prem file sharing made simple, fast and safe.

★ 997⑂ 41👁 1⑃ 1,365● 134▤ 24
GoApache-2.0Created 2024-10-04docs.safebucket.io
下载:v0.8.1v0.8.1 ↓0.8.12026-11-05
+0
日增长
997
stars
41
forks
1
watchers
1,365
prs
134
issues
24
releases

README

An open source file sharing platform with pluggable infrastructure where files bypass the server
  






[![GitHub Release][release-img]][release]
[![Backend Quality][backend-img]][backend]
[![Backend Integration tests][integration-img]][integration]
[![Frontend Quality][frontend-img]][frontend]
[![Docker Build][docker-build-img]][docker-build]
[![License: Apache-2.0][license-img]][license]



!SafeBucket List View

 Features

- Direct uploads and downloads via presigned URLs: files bypass the server
- Swappable infrastructure: every component (storage, database, events, cache, notifier) can be replaced
- SSO via any OIDC provider, with local auth for external users
- Role-based access control at platform and bucket level
- Quick/reverse share: share file via public links with options (password, max downloads, max views, etc...)
- Real-time activity tracking and audit logs
- Multifactor authentication (TOTP)
- File expiration, trash with configurable retention
- Admin dashboard with platform-wide statistics

And more... see the full list of features.

 Architecture

!SafeBucket HLD

 Quick Start

bash
git clone https://github.com/safebucket/safebucket.git
cd safebucket/deployments/local/lite
docker compose up -d


- Go to http://localhost:8080
- Log in with:
    - login: [email protected]
    - password: ChangeMePlease

 Note: If you are accessing Safebucket from an external machine (e.g. Proxmox), you need to update the following
 environment variables in the .env file with your host's IP or domain:
 - STORAGE__RUSTFS__EXTERNAL_ENDPOINT
 - APP__ALLOWED_ORIGINS
 - APP__API_URL
 - APP__WEB_URL

 Verify Image Signature

All published container images are signed with cosign using keyless signing via
GitHub Actions OIDC: no manual keys are involved.

You can verify the signature of any published image using the following commands:

bash
cosign verify \
  --certificate-oidc-issuer=https://token.actions.githubusercontent.com \
  --certificate-identity-regexp=https://github.com/safebucket/safebucket/ \
  ghcr.io/safebucket/safebucket:


Replace  with the image tag you want to verify (e.g., latest, v1.0.0).

 License

This project is licensed under the Apache 2.0 - see the LICENSE file for details.

 Acknowledgments

- Built with ❤️ using Go and React
- UI components by Radix UI and shadcn/ui
- Database ORM by Gorm
- Database migrations by Goose
- Pub/sub integrations by Watermill
- Configuration management by Koanf
- Icons by Lucide

[release]: https://github.com/safebucket/safebucket/releases

[release-img]: https://img.shields.io/github/v/release/safebucket/safebucket

[backend]: https://github.com/safebucket/safebucket/actions/workflows/quality-backend.yml

[backend-img]: https://github.com/safebucket/safebucket/actions/workflows/quality-backend.yml/badge.svg

[integration]: https://github.com/safebucket/safebucket/actions/workflows/integration-backend.yml

[integration-img]: https://github.com/safebucket/safebucket/actions/workflows/integration-b

Top issues

Latest release

v0.8.1 v0.8.1 2026-11-05
What's Changed
 Bug Fixes
 fix: Cloudflare R2 trash error by @yohanleb in https://github.com/safebucket/safebucket/pull/1472
 fix: add manual object reconciliator by @yohanleb in https://github.com/safebucket/safebucket/pull/1477


Full Changelog: https://github.com/safebucket/safebucket/compare/v0.8.0...v0.8.1

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON