Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installing on Windows (WSL)

These are simple instructions to get Windows Subsystem for Linux installed. Once you have a shell in it, follow Installing on Linux.

Note: WSL 2 at the moment requires the wsl2binds plugin. You can install it with omegga install gh:meshiest/wsl2binds

To enable WSL, run this in powershell as an administrator:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Then in the Microsoft Store, download a linux:

More Advanced Instructions here if the above is not sufficient.

To set WSL version from 2 to 1:

  1. Check WSL version with wsl -l -v in cmd
  2. In Administrator cmd, run wsl --set-version <distribution name> 1 where <distribution name> is Ubuntu, Debian, etc. (From the NAME section of the previous command)

WSL2 Networking

WSL2 has its own network, so the game server is not reachable from outside the machine without forwarding. The wsl2binds plugin forwards UDP traffic for you and prints the netsh command to run for the web UI:

omegga install gh:meshiest/wsl2binds

EACCES on npm i -g omegga

Under WSL 1 the global install sometimes fails with EACCES. Try the npm fix first. Failing that, switch to WSL 2, run npm i -g omegga there, and switch back to WSL 1 if that is where you want to run.