The MSL Wiki
Real Linux on your Mac. 123 articles, 20 chapters — the guide that ships inside the app, and the chapters written for the web.
First steps
All 20 chapters
Welcome
6 articlesWhat MSL is, a quick tour, and the words you'll keep seeing.
Getting Started
6 articlesFrom nothing to a running Linux app, one step at a time.
The Main Window
5 articlesThe sidebar, the header, the tabs, and the banners that come and go.
Applications Tab
7 articlesLinux GUI apps as real Mac windows — find them, open them, keep them in your Dock.
Terminal & Shells
5 articlesA real Linux shell in the app, in Terminal.app, over SSH, or from the msl command.
Overview Tab
7 articlesCPUs, memory, disk, the shared home folder — what each instance is made of.
Managing Instances
5 articlesRename and copy them, see where one came from, seal one shut, and reach a port inside.
Tools Tab
15 articlesThe background service, snapshots, stopping and removing, and disk check and repair.
Sandbox Tab
4 articlesCut an instance off from the network, your files, graphics or input — and watch what it says.
MSL Files
8 articlesBrowse your Mac and your Linux instances side by side, and move files between them.
Graphics & mslgd
4 articlesHow Linux windows get onto your screen, what OpenGL apps need, and the tricks for the stubborn ones.
Experimental Features
10 articlesThe switches that make Linux apps behave like Mac apps — what each one does, and what it can still get wrong.
Power & Lifecycle
3 articlesWhat happens when your Mac sleeps or shuts down, when instances sit idle, and why distros share.
Reaching it from anywhere
6 articlesPublish an instance's SSH so another computer, on another network, can log in.
Admin Portal
7 articlesDecide what this Mac is allowed to do with MSL — and say who decided, and why.
Updates
3 articlesHow MSL finds a new version, which releases it raises on its own, and what the version number tells you.
Troubleshooting
14 articlesSymptoms first, then what to do — and where to look when that isn't enough.
Command line
1 articleEverything msl --help prints, here.
Reference
5 articlesEvery shortcut, every command, every file, every word.
Error codes
2 articlesEvery stop code MSL can show, what raised it, and what to do about it.