r/SelfHosting • u/cidadaoaleatorio • 9h ago
Show HN / Self-Hosted: Malta OS – A windowed desktop environment in the browser to manage Linux servers (OS.js + FastAPI + PAM)
Hi r/selfhosted!
I’d like to share Malta OS (`iwa-webos`), an open-source project designed as a windowed desktop alternative to traditional server dashboards like Cockpit, CasaOS, or Webmin^(\[1\]).
Instead of static web pages or tabbed menus, Malta OS brings a full multi-window desktop interface directly into your browser.
🛠️ Architecture & Security
* Frontend Shell: Powered by OS.js with window controls (minimize/maximize), a GNOME-style launcher, customizable themes (Win11, macOS, KDE, GNOME), widgets, and wallpapers^(\[1\]\[2\]).
* Privileged Agent: A Python FastAPI backend running locally on `127.0.0.1:8765`, accessible exclusively via the OS.js authenticated proxy.
* Real System PAM Auth: Logins validate directly against `/etc/passwd` and `/etc/shadow` via `pam_unix`^(\[1\]\[5\]). Users must belong to the `webos` group to access the system.
* User Session Isolation: Web terminal sessions spawn PTY instances executing `setuid` to match the exact logged-in Linux user.
📦 Key Features & Built-in Apps
* Terminal: Multi-tab PTY terminal using xterm.js.
* Services & System Logs: Manage `systemd` units (start/stop/enable) and filter `journalctl` logs with live tailing.
* Disks & Partitions: Disk partition management powered by `lsblk`, `parted`, and `mkfs`.
* Docker & App Store: Manage containers/images via the Docker socket and install one-click server apps using the CasaOS AppStore index.
* Files & Code Editor: File manager accessing the host filesystem with an integrated Monaco code editor.
* Remote Access & Cloud Backup: Manage saved SSH/SFTP/Git connections and schedule Google Drive backups via `rclone`.
* Cron & SysInfo: Visual crontab scheduler and live CPU/RAM/Disk/Network gauges.
⚡ Quick Demo & Testing
You can try Malta OS without modifying your host system using an isolated Docker container running Ubuntu 24.04 with systemd as PID 1:
git clone https://github.com/tiagoiwamoto/iwa-webos.git
cd iwa-webos
./install.sh --docker
For native host installation, running `./install.sh` sets up the native `systemd` services (`webos-agent` and `webos-web`). It has been tested on x86_64 as well as ARM hardware like Raspberry Pi 2, Orange Pi, and Walnut Pi.
* GitHub Repository: https://github.com/tiagoiwamoto/iwa-webos
Feedback, suggestions, and contributions are very welcome!
`#linux` `#sysadmin` `#devops` `#selfhosted` `#homelab` `#opensource` `#python` `#fastapi` `#docker` `#raspberrypi` `#casaos` `#cockpit` `#webmin`






