Skip to content
Guide / Reference
Credits and licences
Who made MSL, the licences it's under, and where to read more.
Chapter 19 of 20 1 min read Reference
The full story is in the About MSL window — choose MSL ▸ About MSL .
In the About window# About — the melon, MSL's logo; the version; and the mascot, illustrated by neekocat_2025.Licence — the full text, and why one repository has two licences.Contributors — everyone who has landed a commit, read live from GitHub, each with their own colour.Extras — what MSL is for, and the story of writing an X11 server from scratch.Licences# MSL is free software.
mslgd — the X11 server, its per-app window hosts and the guest-side tunnel, and anything derived from them — is under the GNU General Public License v3 . Use it, change it, share it; if you share changes, share their source too. The app ships with mslgd built in, so the app as a whole is GPL v3.Everything else — the app, the msl command, the background service, MSL Files, the guest daemons and the virtual-machine plumbing — is under the MIT licence , so anyone can use it for anything.aside Thank you
For trying a small, stubborn project that set out to make Linux feel at home on a Mac. If something in this guide is wrong, or missing, that's a bug too. ♡ (˶ᵔ ᵕ ᵔ˶)
What the colours mean
Chapters about similar things share a colour. Pick one to see only those chapters.
Basics What MSL is, and your first steps with it. Welcome · Getting Started The app The main window and the tabs you use every day. The Main Window · Overview Tab Linux apps & graphics Linux GUI apps as Mac windows, and how they get drawn. Applications Tab · Graphics & mslgd · Experimental Features Shells & remote access Terminals, SSH, the msl command, and reaching an instance from elsewhere. Terminal & Shells · Reaching it from anywhere · Command line Instances & files Looking after machines, moving files, and sleep and power. Managing Instances · MSL Files · Power & Lifecycle Upkeep Snapshots, disk checks, maintenance and updates. Tools Tab · Updates Security & control Cutting an instance off, and locking a Mac down. Sandbox Tab · Admin Portal Troubleshooting When something goes wrong: symptoms first, then fixes. Troubleshooting Reference Every shortcut, command, file and word. Reference · Error codes