🚀 CloudBox

A self-hosted Backend-as-a-Service (BaaS) platform that provides essential backend services for modern applications.

🌟 Features

🚀 Core Services

• Authentication & User Management - JWT-based auth with roles and permissions
• Database Management - RESTful API for document storage and retrieval
• File Storage - Upload, manage and serve files with organized bucket system
• Real-time Messaging - WebSocket-based messaging with channels and rooms
• Serverless Functions - Multi-runtime function execution (Node.js, Python, Go) with Docker isolation
• Automated Deployments - Git-based deployments with webhook support
• Backup & Restore - Comprehensive project backup with atomic restore capabilities

🛠 Developer Tools

• Admin Dashboard - Real-time statistics and system health monitoring
• Project Management - Multi-project organization with encrypted API keys
• Plugin Marketplace - GitHub-based plugin ecosystem with security validation
• Script Runner - Universal SQL/JavaScript execution with project templates
• User Analytics - Growth metrics and usage statistics based on actual data
• System Monitoring - Live performance tracking and resource utilization
• SSH Management - Secure SSH key management with host verification
• Security - AES-256-GCM encryption and comprehensive audit logging

🔧 Technical Stack

• Frontend: SvelteKit + TypeScript + TailwindCSS
• Backend: Go + Gin Framework + GORM
• Database: PostgreSQL
• Cache: Redis
• Deployment: Docker + Docker Compose

🏗️ Architecture

cloudbox/
├── backend/          # Go API server
├── frontend/         # Svelte web dashboard  
├── cli/             # CloudBox CLI tool
├── sdks/            # Client SDKs
├── docs/            # Documentation
└── docker/          # Container configurations

🚀 Quick Start

Prerequisites

• Docker & Docker Compose
• Git

Automated Installation

# Clone the repository
git clone https://github.com/ekoppen/cloudbox.git
cd cloudbox

# Run the installation script
./install.sh

# Or with custom configuration
./install.sh --frontend-port 8080 --backend-port 9000 --host myserver.com

Manual Installation

# 1. Clone repository
git clone https://github.com/ekoppen/cloudbox.git
cd cloudbox

# 2. Configure environment
cp .env.example .env
# Edit .env with your configuration

# 3. Start services
docker-compose up -d

# 4. Access your CloudBox
open http://localhost:3000

Installation Options

# Basic installation
./install.sh

# Custom ports
./install.sh --frontend-port 8080 --backend-port 9000

# Remote server installation
./install.sh --host myserver.com --frontend-port 3000

# Update existing installation
./install.sh --update

# Full options
./install.sh --help

📚 Documentation

• Getting Started
• Installation Guide
• Plugin System
• Plugin Marketplace
• API Reference
• SDK Documentation
• Configuration
• Deployment Guide
• Development Guide
• Troubleshooting

🔧 Development

See Development Guide for local development setup.

📄 License

MIT License - see LICENSE file for details.