SGS

A free, self-hosted object storage solution. View the online documentation here

Features

• 📁 Project-based file organization
• 🔑 API key management
• 🔗 Pre-signed URLs for time-limited sharing
• 📤 File operations (upload/download)
• 🔒 Built-in authentication
• 🐳 Docker ready

Preview

Dashboard

Project Management

API Keys

File Upload

Setup

# clone the repository
git clone https://github.com/mrshabel/sgs.git

# navigate to project directory
cd sgs

# copy example env file
cp .env.example .env

# start services with Docker
make docker-run

Edit the .env file to configure:

• Port settings
• Database credentials
• Storage credentials
• JWT secrets

Development

Requirements:

• Go 1.23+
• Docker
• Node.js 20+

# install dependencies
go mod download
make watch

# Frontend
cd web
npm install
npm run dev

Testing

make test

TODO

[] In-App Notifications [] File Versioning