Skip to content

Home

Jump to bottom
Aum Sahayata edited this page Jul 23, 2025 · 4 revisions

📦 CloudBoxIO

CloudBoxIO is a lightweight, self-hosted file storage and sharing service built using Go and Fiber. It supports file uploads, secure JWT-based authentication, shared/public files, and more — all backed by SQLite for simplicity and portability.

🚀 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

⚙️ Tech Stack

  • Language: Go (Golang)
  • Web Framework: Fiber
  • Database: SQLite
  • Auth: JWT
  • Logging: Standard Library log package
  • Environment Handling: godotenv

📚 Documentation

🔧 Installation & Setup

Prerequisites

🧾 Logging Overview

Logs are saved to logs/server.log by default.

Optional file operation logs go to logs/fileops.log when LOG_FILE_OPS=true (Default true).

Console logging for server logs can be toggled using LOG_TO_CONSOLE=true (Default true).

📄 License

This project is open-source and available under the MIT License.

🤝 Contributing

Have an idea or want to contribute?

  • 💬 Join the Discussions for questions or ideas
  • 🐞 Report bugs via Issues
  • 🤖 Suggestions for enhancement:
    • 🔄 Docker support
    • 🖥️ Frontend UI
    • 🧪 More tests (unit/integration)
    • 🛠️ GitHub Actions / CI

👨‍💻 Author

Built with ❤️ by Aum Sahayata

Clone this wiki locally