How to install Manjaro on WSL for Windows 10 and 11
Manjaro is a popular Linux distro not offered through the Microsoft Store, so here’s how to install it on WSL.
When you purchase through links on our site, we may earn an affiliate commission.Here’s how it works.
TheWindows Subsystem for Linux (WSL)is an incredibly powerful tool for both Windows 10 andWindows 11with a raft of easily installable distros at hand in the Microsoft Store. But you’re not limited to only those available through the Store. It’s perfectly possible to install other distributions using the built-in WSL tools so long as you have the right files on hand.
In some cases, such as Ubuntu, you can installthe latest rolling releasewith an official image. In others, we turn to the WSL community for assistance, and that’s exactly the case for anyone looking to install Manjaro.
Thanks to a project hosted on GitHub, installing Manjaro on WSL is a breeze. Let’s get to it.
How to install Manjaro on WSL
Manjaro is an Arch-based Linux distribution and is certainly one of the more mainstream options out there. Of course, using Linux in WSL is a little different from just loading it up on a PC, but if you need it, you need it. Indeed, Valve has already told developers interested in theSteam Deckand Steam OS 3.0 to use Manjaro to get ready.
So, if you want to use it on WSL, you’ll be needing to use an excellent community project simply called ManjaroWSL. It’s hosted at GitHub, so the first port of call is to load upits repository. It’s also only built for WSL 2, so if you aren’t using that yet, check outour full guideto get ready. It does, however, support both Intel/AMD and ARM machines, so Windows on ARM users aren’t left out.
On the GitHub repository, hit thereleasespage and download the latest package. Once downloaded, extract the zip file to the directory you want to run it from, then simply runManjaro.exe. Unlike installing Ubuntu’s latest releases from one of the official images, this has been bundled up to more closely resemble the distros you would download from the Microsoft Store.
It’ll take a few seconds (or longer depending on your hardware) to run its installation, but the installer doesn’t require any interaction from you. It’ll open a terminal window and when it’s complete you’ll be asked to pressEnter. The terminal window will then close.
Get the Windows Central Newsletter
All the latest news, reviews, and guides for Windows and Xbox diehards.
If you use Windows Terminal, Manjaro will now be in the dropdown menu to launch the next time you load it up. If you don’t, you can launch it through PowerShell the same as any other Linux distro with this command:
By default you’ll only have root access, so you’ll need to do some basic setup before you get rolling.
How to set up Manjaro on WSL
Enter Manjaro in one of the methods described above. You’ll be presented with a basic prompt that begins with
. As with any other Linux distro on WSL, you’ll want to add a user to Manjaro with the right permissions before doing anything. You don’t have a password, either, so you’ll need to add one of those before beginning.
In the terminal enter:
Follow the prompts to set up a root password. Next, we’ll add a user with:
And then we’ll follow that up with a password for the user with:
Again, follow the prompts to set a password for the user. These commands have added a user, created a home directory for that user with the
flag, and added a user password.
The next step is to add your user account to the right group to be able to use the sudo command, otherwise you’ll be met with an error:
You can then switch to your user with:
Thisshouldwork without issue and allow you to execute the sudo command, but if you’re met with an error relating to thesudoersfile, you’ll need to make a couple of changes. As root, enter
and you’ll see a warning that it’s supposed to be read only. Ignore it, but you will need to be a little careful. You’re also really supposed to edit this with
, but for what we’re doing here nano will be ok.
Scroll down and find this block:
Uncomment (delete the #) on thesecond line only. HitCtrl + Xfollowed byYand thenEnterto save and exit. Now you shouldn’t see any more errors when you switch back to your user.
The next thing to do is to ensure that when you launch Manjaro, if you want to be user and not root (which is advisable), you configure it so you don’t have to manually do it every time. There are two ways to do this: the first is with thewsl.conffile, and the second is by configuring Windows Terminal if you use that.
You won’t have a wsl.conf file when you first set up Manjaro, so we’ll need to create that and enter the right settings. As we’re going to be inside the /etc/ directory it’s easiest to stay as root for this one. In the terminal enter:
The nano text editor will now open with a new blank file. Enter this block into the file:
HitCtrl + Xfollowed byYand thenEnterto save and exit. Close down your Manjaro instance, wait a few seconds, and when you relaunch you should be ready to roll as user.
Alternatively, if you’re using Windows Terminal, open theSettings, find your Manjaro install in the sidebar, and in thecommand linebox ensure this command is stored:
This will have the same effect once closed down and restarted.
How to configure your Manjaro package manager on WSL
Before you can get really rolling there’s one final thing to do: set up the package manager. If you try to install something right now you’ll be met with an error relating to the mirror. So we need to tell Manjaro where to look.
Enter this command into your terminal:
So, for example, I enter:
For countries with more than one word, separate with an underscore. Once this completes, enter this command to update:
You’ll most likely have a bunch of updates that need to install so it’ll take a minute, but Manjaro is extremely fast in WSL.
You should now be able to install packages without error. If this is your first time, the basic command to remember is:
So, for example, to install Neovim you would enter:
Additionally, and perhaps preferably, you can useManjaro’s own package manageras well. You’ll need to install it, but it might be worth doing as it’s a little more straightforward to interact with than pacman.
To install it enter:
You’re now all set up to get using Manjaro on WSL. As with other distros, you can run multiple separate Manjaro instances, and if you want to install another, simply go back to the beginning of this guide and run it all again. Simply change the filename of the installer before you start, and it will install another instance completely separate to your existing one.
Richard Devine is a Managing Editor at Windows Central with over a decade of experience. A former Project Manager and long-term tech addict, he joined Mobile Nations in 2011 and has been found on Android Central and iMore as well as Windows Central. Currently, you’ll find him steering the site’s coverage of all manner of PC hardware and reviews. Find him on Mastodon atmstdn.social/@richdevine
