Install mvmOS
Run a full desktop environment on your Linux server. Install takes less than 5 minutes.
Quick Install
Run this on your Linux server, as root or with sudo:
curl -fsSL https://github.com/mvmrik/mvmOS/archive/refs/heads/main.tar.gz | tar -xz && cd mvmOS-main && bash install.sh
System Requirements
Linux
Ubuntu 20.04+, Debian 11+, or any modern distro
Python 3.10+
Required for the FastAPI/uvicorn backend
A browser
Any modern one — the desktop runs entirely in it
512 MB RAM
Minimum. 1GB+ recommended for smooth operation
Installation Steps
Run the installer
Use the Quick Install command above. It asks for a port (2026 by default), installs mvmOS into /opt/mvmos and starts it as a systemd service, then removes the downloaded folder. It does not touch nginx or your firewall.
Open in your browser
Go to your server's address on the port the installer prints, and sign in with a Linux user account from that machine — mvmOS has no separate password of its own.
Install apps from the Store
Open the App Store from the desktop and install anything you need.
Updating and uninstalling
Updates are built in: mvmOS downloads and applies new versions itself from Settings, keeping your apps, data and settings. There is nothing to pull or re-run by hand. To remove mvmOS completely, run:
sudo systemctl disable --now mvmos; sudo rm -f /etc/systemd/system/mvmos.service; sudo systemctl daemon-reload; sudo rm -rf /opt/mvmos
This deletes everything mvmOS owns — installed apps, desktop settings and app data. Your Linux users and their home directories are not touched.
Optional, once it runs
mvmOS serves itself on its own port, so none of this is needed to get started — but on a machine reachable from the internet it is worth doing. Put nginx, Caddy or a Cloudflare Tunnel in front to get a domain and HTTPS, and keep the port itself closed to the outside. mvmOS can manage nginx sites for you from the Sites app once it is installed.
Optional: mvmOS Desktop
Not needed to install or use mvmOS — the desktop runs in any browser. mvmOS Desktop is a separate native app for your own computer that opens the mvmOS servers you already have in tabs, several at once.
About mvmOS Desktop