safebucket /safebucket
On-prem file sharing made simple, fast and safe.
★ 997⑂ 41👁 1⑃ 1,365● 134▤ 24
+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-bTop issues
#1366[Feature Request] OIDC Role Mapping4 comments · 2026-08-26#1277feature: Machine-to-machine API authorization2 comments · 2026-07-19#1444Feature Request: SMB / WebDAV access to buckets and files + encryption1 comments · 2026-10-17#1162Add client side encryption1 comments · 2026-05-19#1161Add thumbnails for images and videos1 comments · 2026-05-19#1498bug: OIDC login does not retrieve first and last names0 comments · 2026-11-12#1479Feature: admin data guard0 comments · 2026-11-02#1474bug: delete failed upload0 comments · 2026-11-01
Latest release
v0.8.1 v0.8.1 2026-11-05What'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