NAS Management • Self-hosted

Truebuntu

A lightweight, self-hosted NAS management web interface for Ubuntu-based ZFS storage servers

Under active development. This project is not production-ready. Do not use on a production server or with important data.

Powerful Features

Everything you need to manage Ubuntu-based ZFS storage servers

ZFS Pool Management

Create and manage mirror, RAIDZ, and stripe pools with full dataset, snapshot, and replication support

SMB & NFS Shares

Configure and manage network file shares for Windows and Linux clients directly from the web interface

SMART & Disk Monitoring

Track disk health with SMART diagnostics, temperature monitoring, and hardware enclosure visualization

System Metrics

Real-time CPU, memory, and storage metrics with alert routing to email, Slack, and PagerDuty

Network Management

Configure network bonding, VLANs, DNS settings, and manage services like DDNS, OpenVPN, and SNMP

Security & RBAC

Role-based access control with JWT authentication, bcrypt passwords, TOTP two-factor auth, and audit logging

Backup & Sync

Scheduled rsync backups, ZFS replication, and cloud sync via rclone to major storage providers

Service Management

Manage FTP, UPS monitoring, OpenVPN, SNMP, and DDNS services from a unified dashboard

Enclosure Visualization

Visual hardware enclosure view showing disk placement, status, and temperature at a glance

Multi-User Access

Role-based user management with granular permissions and complete audit trail of all actions

Single Container

Entire stack runs in one Docker container — FastAPI backend, React frontend, and SQLite database

Cron Scheduling

Built-in cron scheduler for automated snapshots, scrubs, replication tasks, and backup jobs

Single-Container Architecture

One Docker container runs the entire stack — no orchestration complexity

  • FastAPI backend (Python 3.12 + Uvicorn) handles all ZFS and system operations
  • React 18 frontend built with Vite 6 and Tailwind CSS for a responsive dashboard
  • SQLite with WAL mode for configuration, scheduling, and audit log persistence
  • JWT authentication with bcrypt password hashing and optional TOTP 2FA
  • Privileged Docker mode required for direct access to ZFS and disk hardware
  • Port 80 serves both the API and the frontend from a single entry point

Technical Details

Built With

  • React 18 + Vite 6 + Tailwind CSS
  • Python 3.12 + FastAPI + Uvicorn
  • SQLite with WAL mode
  • JWT + bcrypt + pyotp (TOTP 2FA)
  • Docker (privileged mode)

Requirements

  • Docker with privileged mode support
  • Ubuntu-based host with ZFS installed
  • Port 80 — web interface
  • Under active development — not production-ready

Try Truebuntu

Clone the repo, build the container, and manage your ZFS server from a modern web interface