Skip to main content

πŸ“š 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:

StepGuideDescription
1️⃣Create Bootable MediaCreate a USB stick or VM image to boot MOS
2️⃣First WalkthroughComplete initial setup (root password, network, storage)
3️⃣WebUI OverviewLearn the MOS interface and navigation
πŸ§ͺTest in VMTry MOS in a virtual machine first (optional)
πŸ”§ARM Support (Experimental)Install MOS on ARM devices (Orange Pi, Raspberry Pi, etc.)

🎯 What Makes MOS Special?​

FeatureDescription
Modular VirtualizationSupport for Docker, LXC, and VMs out of the box
Smart StorageBuilt-in mergerfs and SnapRAID for flexible, protected storage
Privacy FirstNo telemetry, no tracking, no data collection. Everything runs locally
Energy EfficientLightweight 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:

LayerTechnology
Base OSDevuan Linux (systemd-free, Debian-based)
VirtualizationDocker, LXC, QEMU/KVM
Storagemergerfs, SnapRAID, ZFS support
Web InterfaceVue 3 + Vuetify + REST API + WebSocket

🌐 Get Involved​

ResourceLink
Discord CommunityJoin our Discord
Matrix ChannelJoin our Matrix
Releases & ChangelogGitHub Releases

🌟 Support MOS​

MOS is and will always remain free and open source. If you'd like to support the project, you can make a donation to help us continue development.

ResourceLink
Support ProjectSupport MOS

πŸ–₯️ 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.