About this project

Home Server Interface (HSI) is an open-source control panel designed for single Linux servers. It enables turning a Linux server into a private cloud, NAS, and app platform. The software provides a modern web UI for managing files, running Docker applications, operating storage (including S.M.A.R.T., RAID, and LVM), monitoring hardware, and handling user permissions and backups. Key capabilities include: - A file manager with resumable uploads, a built-in code editor, and expiring public share links, supporting per-user and per-group permissions. - An App Store for guided installation of self-hosted applications with pinned image versions, and full container lifecycle management (create, edit, logs, networks, mounts). - Storage management features: disk health monitoring via S.M.A.R.T., partitioning, formatting, mdadm RAID, LVM, and /etc/fstab management. - Monitoring of CPU, RAM, network, and storage metrics with historical data (1h-7d), background alerts for RAID degradation and failing disks, and an audit trail for privileged actions. - Multi-user support with groups, per-place permissions, admin/storage delegation, and built-in SMB/Samba sharing synced with HSI accounts. - Backup features: encrypted configuration backups (AES-256-GCM) and scheduled rsync backups (local or over SSH, push or pull). HSI is designed to run without hiding the underlying Linux system; created Samba shares, fstab entries, and systemd units remain accessible for manual inspection. The architecture uses unprivileged web backend services and isolates root-level operations via a separate worker process communicating over a message queue. The project is in active pre-1.0 development, tested on Ubuntu 24.04 (x86-64). It has not undergone a formal security audit and may contain vulnerabilities. Installation is done via a one-command script for Ubuntu 24.04, which sets up required dependencies and services.