BoxBox is a self-hosted file manager for homelab and NAS-style servers. It provides a browser UI for mounted Linux paths, large file and folder uploads, previews, code editing, search, share links, and background file operations.
frontend/ contains the shared Svelte UI, desktop/ the Linux Electrobun app with bundled CEF, and website/ the marketing site. The Go API stays in backend/. Run bun install --cwd frontend and bun install --cwd desktop, then bun run dev:desktop for local filesystem access. Each package has its own lockfile. See desktop setup and remote mode.
Community mentions
- MadeWithSvelte featured BoxBox as a self-hosted file manager built with Svelte.
- Golang News shared BoxBox with the Go community.
Features
- Browse multiple configured mount points from one web UI, with drives and folder shortcuts (places) listed separately.
- Upload large files and whole folders with chunked, resumable uploads that keep nested paths intact.
- Preview images, audio, video, PDF, and documents, and edit text and code in the built-in Monaco editor.
- Share files and folders with expiring, revocable links. Access levels are View only, Upload only, Upload + delete, and Full access. Recipients see your wallpaper.
- Download folders as ZIP archives from the browser or a public share page.
- Copy, move, and delete files through background jobs with live WebSocket progress.
- Search directories by file or folder name.
- Configure read-only mounts, users, rate limits, and allowed origins.
Quick Start
The preferred deployment path is Docker Compose using the published GitHub Container Registry image. No source checkout is required.
mkdir -p boxbox
cd boxbox
curl -fsSLO https://raw.githubusercontent.com/jR4dh3y/BoxBox/master/docker-compose.yml
curl -fsSLO https://raw.githubusercontent.com/jR4dh3y/BoxBox/master/.env.example
mkdir -p backend
curl -fsSL https://raw.githubusercontent.com/jR4dh3y/BoxBox/master/backend/config.yaml -o backend/config.yaml
cp .env.example .env
$EDITOR .env
docker compose pull
docker compose up -d
Generate the bcrypt value requested by .env, then open http://localhost:8080 and sign in as admin with the plaintext password you hashed. For reverse proxy examples, local source builds, and update workflows, see docs/docker.md.
Screenshots
Repository Layout
backend/ Go API server and embedded frontend host
frontend/ SvelteKit application
docs/ Public project documentation
scripts/ Local development helpers
Dockerfile Unified frontend/backend production image
Documentation
Full documentation lives at boxbox.radhey.dev/docs. Release and upgrade notes are in docs/release.md.
License
MIT. See LICENSE.
The promo video uses “the kill 2” by Lex Amarni & 2muchmotion. The song is credited to its artists and is not covered by the MIT license.
