BhusalHub
An offline-first, self-hosted personal infrastructure platform for Raspberry Pi.
BhusalHub is not a media server — it is a Personal Infrastructure Platform.
Media management is the first capability built on top of that platform.
Overview
BhusalHub transforms a Raspberry Pi 4B (2 GB RAM) into a resilient home cloud. It unifies media management, file access, and system monitoring behind a single secure web portal — no internet required for core functionality.
Documentation
Full engineering handbook at docs/:
| Part | Contents |
|---|---|
| Part 0 | Project Charter |
| Part I | Vision, Requirements, Principles, Tech Decisions |
| Part II | System Context through Monitoring |
| Part III | Frontend, Backend, API, Folder Structure |
| Part IV | Operations, Performance, Runbook |
| Part V | Roadmap & Future Extensions |
| Appendices | ADRs, Schema, API Ref, Docker Compose |
Tech Stack
| Layer | Choice |
|---|---|
| Frontend | React + Vite (static SPA) |
| Backend | ASP.NET Core 8 |
| Database | SQLite |
| Proxy | Nginx |
| Runtime | Docker Compose |
| Remote access | Cloudflare Tunnel |
| Hardware | Raspberry Pi 4B, 2 GB RAM, USB 3 SSD |
Quick Start
# Clone the repo and read the handbook first
git clone git@github.com:bharatbhusal/BhusalHub.git
cd BhusalHub
See docs/part-iv-operations/34-operations-runbook.md for deployment and daily operations.
License
This project is licensed under the terms of the LICENSE file in this repository.