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:
git clone https://github.com/mvmrik/mvmOS.git && cd mvmOS && bash install.sh
Desktop Client
A native app for opening your mvmOS installations in their own window — tabs, several servers at once, no browser chrome. Latest version: v0.4.8.
Optional — mvmOS itself needs nothing installed on your device, it runs entirely in the browser. This client is a convenience for switching between servers.
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
Clone the repository
git clone https://github.com/mvmrik/mvmOS.git cd mvmOS
Run the install script
bash install.sh
The script sets up the Python environment and the systemd service. 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.
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.