Built for modern Linux with a reactive JS stack that replaces legacy PHP panels. Features a seamless Python-based graphical installer packaged as an AppImage for cross-distro compatibility.
| Layer | Technology |
|---|---|
| Frontend | React 19, Tailwind CSS 4, Vite 6, xterm.js, noVNC |
| Backend | Node.js 22, Express 4, Socket.io 4, TypeScript |
| Installer | Python 3, PyQt6, AppImage, Polkit |
| Integration | node-pty (terminal), noVNC + VNC/RDP discovery (remote desktop) |
| System | systemd, Samba, NFS, Docker, firewalld, SELinux |
tux-panel/
├── client/ # React frontend (Vite)
│ ├── src/ # Dashboard, Terminal, RemoteDesktop, Disks, etc.
│ └── vite.config.js # Builds to dist/
├── server/ # Express + Socket.io backend (TypeScript)
│ ├── src/ # REST API endpoints, WebSockets, system services
│ └── scripts/ # System wrappers (tuxpanel-priv-wrapper.sh)
├── installer/ # Python PyQt6 GUI Installer & system tray
│ ├── build-appimage.sh # Script to bundle the installer into an AppImage
│ └── src/ # Installer logic, distro detection, polkit integration
├── scripts/ # System-level setup scripts for dev
└── package.json # Root workspace (concurrently)
- Download the latest
TuxPanel-Installer-*.AppImagefrom the Releases page. - Make it executable:
chmod +x TuxPanel-Installer-*.AppImage - Run the installer to open the GUI wizard. The installer handles system dependencies, daemon setup, and polkit escalation automatically.
# 1 — Clone
git clone git@github.com:JosephDoesLinux/tux-panel.git
cd tux-panel
# 2 — Install Node packages and build
npm run install:all
npm run build
# 3 — Set up the developer environment (Fedora target)
sudo groupadd tuxpanel
sudo usermod -aG tuxpanel $USER
# Log out and back in for group to take effect
sudo bash scripts/install-deps.sh
echo -e 'auth required pam_unix.so\naccount required pam_unix.so' | sudo tee /etc/pam.d/tuxpanel
cp server/.env.example server/.env
# 4 — Run dev servers (API on :3001, UI on :5173)
npm run dev| Page | Description |
|---|---|
| Dashboard | Real-time CPU, RAM, disk, network gauges |
| Terminal | Full web terminal (xterm.js + node-pty over WebSocket) |
| Remote Desktop | In-browser VNC/RDP via noVNC + systemd integration |
| Disks | Block devices, SMART health, BTRFS subvols, mounts |
| Services | systemd unit control (start/stop/restart/logs) |
| Containers | Docker management (ps, images, logs, stats, inspect) |
| Accounts | Linux user & group CRUD |
| Troubleshooting | journalctl, dmesg, failed units, network tools |
| AI Chatbot | Integrated AI assistant for system administration |
🖼️ Click to view gallery
Real-time system health metrics, CPU, RAM, and Network activity gauges.
Seamless in-browser VNC/RDP sessions natively spawned by the dashboard via systemd.
Full-featured interactive bash terminal inside the browser utilizing xterm.js.
View, start, stop, and inspect systemd daemons and applications on the host system.
Full container orchestration, image details, and lifecycle state management.
Integrated AI context-aware chatbot for querying configuration files and diagnosing system issues.
TuxPanel emphasizes security by completely avoiding arbitrary shell commands (sudo / exec).
- No shell execution — All commands use localized arguments and bypass interactive shells.
- Polkit Integration — Custom
pkexecwrappers and polkit rules are utilized rather than relying onsudopasswords. - Allow-listed Commands — The backend strictly verifies every executable against a static whitelist before passing it to
tuxpanel-priv-wrapper.sh. - AppImage Extensibility — The installer handles system placement (
/opt/tuxpanel) while letting the backend Node daemon operate efficiently viasystemd.
See ARCHITECTURE.md and DOCUMENTATION.md for more details.
MIT © JosephDoesLinux & Merheb Merheb
