📚 Welcome to MOS-Docs
MOS (Modular Operating System) is a lightweight, web-based management system for servers and homelabs — built on Devuan Linux.
It's designed for small, energy-efficient home servers, delivering a modern interface with maximum functionality and zero bloat.
🚀 Getting Started
New to MOS? Follow these steps to get up and running:
| Step | Guide | Description |
|---|---|---|
| 1️⃣ | Create Bootable Media | Create a USB stick or VM image to boot MOS |
| 2️⃣ | First Walkthrough | Complete initial setup (root password, network, storage) |
| 3️⃣ | WebUI Overview | Learn the MOS interface and navigation |
| 🧪 | Test in VM | Try MOS in a virtual machine first (optional) |
| 🔧 | ARM Support (Experimental) | Install MOS on ARM devices (Orange Pi, Raspberry Pi, etc.) |
🎯 What Makes MOS Special?
| Feature | Description |
|---|---|
| Modular Virtualization | Support for Docker, LXC, and VMs out of the box |
| Smart Storage | Built-in mergerfs and SnapRAID for flexible, protected storage |
| Privacy First | No telemetry, no tracking, no data collection. Everything runs locally |
| Energy Efficient | Lightweight OS based on Devuan for home servers |
👥 Who Is MOS For?
MOS is designed for:
- Homelab enthusiasts who want full control over their infrastructure
- Privacy-focused users who refuse telemetry and cloud dependencies
- Developers and self-hosters looking for a modern, lightweight platform
- Resource-constrained environments where every MHz and MB counts
🔒 Open Source & Privacy
MOS is and will always remain fully open source under the GNU AGPLv3 license.
We believe in:
- Transparency: All code is publicly available on GitHub
- Privacy: No telemetry, no tracking, no data collection
- Modularity: Install only what you need — nothing extra
📦 MOS Components
MOS is built from multiple open-source components:
| Layer | Technology |
|---|---|
| Base OS | Devuan Linux (systemd-free, Debian-based) |
| Virtualization | Docker, LXC, QEMU/KVM |
| Storage | mergerfs, SnapRAID, ZFS support |
| Web Interface | Vue 3 + Vuetify + REST API + WebSocket |
🌐 Get Involved
| Resource | Link |
|---|---|
| Discord Community | Join our Discord |
| Report Issues | GitHub Issues |
| Releases & Changelog | GitHub Releases |
🖥️ MOS Releases
📚 MOS Documentation
🎨 Frontend and API
💾 Base OS
🐳 Base Packages
🔧 MOS Specific Packages
💾 MOS Misc Custom Repositories
Parts of this documentation were created with the assistance of AI tools. All AI-generated content has undergone review, but it may still contain inaccuracies, omissions, or outdated information.