Skip to content

CloudBoxIO is an open source, lightweight, self-hosted file storage and sharing service built using Go.

License

Notifications You must be signed in to change notification settings

AumSahayata/cloudboxio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📦 CloudBoxIO

A lightweight, self-hosted file storage and sharing server built with Go and Fiber.

CloudBoxIO allows users to securely upload, share, and manage files with JWT-based authentication and an optional minimal UI. Built for simplicity and portability, it runs as a single binary and stores data using SQLite.


🚀 Features

  • 🔐 User authentication and authorization using JWT
  • 📁 Upload, list, and download personal files
  • 🌐 Shared file support (public listing)
  • 🗑️ File deletion
  • 🧠 Filename conflict resolution (e.g., file(1).txt)
  • 📊 SQLite-based metadata and user storage
  • 📂 Optional file logging and server logs
  • 🧠 Auto-generated .env file with required flags and JWT secret
  • 🎛️ Admin-only user management
  • 🗂️ Upload multiple files
  • 🛑 Graceful shutdown
  • 📱 Minimal Web UI
  • 🔍 Search through uploaded or shared files by filename using query parameters
  • 🚧 Rate Limiting
  • 🧪 Unit testing

</> UI

CloudBoxIO includes a clean, responsive UI for file management out of the box.

Landing page

Dashboard page

Mobile view


⚡ Quick Start

✅ Requires Go 1.24 or higher (Go is only needed if building from source)

git clone https://github.com/AumSahayata/cloudboxio.git
cd cloudboxio
go mod tidy
go build .
./cloudboxio

💡 A .env file will be generated automatically on first run. You can edit it to change port, file directories, upload size, rate limiting, and more.


📚 Documentation

See the Wiki for full documentation:


📄 License

This project is licensed under the MIT License


💬 Need Help or Want to Contribute?

  • Your feedback, ideas, and contributions are always welcome. Whether it’s fixing a bug, improving the docs, or suggesting a new feature — every bit helps make CloudBoxIO better for everyone.
  • Ask questions or share ideas in Discussions
  • Report bugs via Issues
  • Suggestions welcome! You can contribute:
    • 🔄 Docker support
    • 💻 Frontend improvements
    • 🛠️ CI pipelines or GitHub Actions
    • 🧪 Integration testing
    • 🆕 Bring your own idea

👨‍💻 Author

Made with ❤️ by Aum Sahayata


About

CloudBoxIO is an open source, lightweight, self-hosted file storage and sharing service built using Go.

Topics

Resources

License

Stars

Watchers

Forks