How to install elementary OS on WSL for Windows 10 and 11
elementary OS 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. With the right tools and know-how, you can get just about any distro working.
In some cases, such as Ubuntu,you can install the latest rolling releasewith an official image. In others, we turn to the WSL community for assistance, and that’s where we’re at with elementary OS.
Thanks to a project hosted on GitHub, installing elementary OS onto WSL is a simple process that takes a matter of minutes, followed by some pretty simple setup.
How to install elementary OS on WSL
Elementary OS is an Ubuntu-based Linux distribution and one of the more mainstream options out there, with one of the most pleasing user interfaces around. Of course, using Linux in WSL is a little different from just loading it up on a PC, and you don’t get the gorgeous UI, but if you need it or just want it, you can have it.
So, if you want to use it on WSL, you’ll be wanting to use a community project simply called ElementaryWSL. 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.
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 runelementary.exe. Unlike installing Ubuntu’s latest releases from one of the official images, this has been bundled up to resemble more the distros you would download from the Microsoft Store with a similar installation process.
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, Elementary will now show 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 elementary OS on WSL
Load up elementary OS in your terminal using 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 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 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 add your password. These commands have added a root password, a user, and a user password.
The next step is to add the right permissions to your user to be able to use the sudo command, otherwise you’ll be met with an error. We can do this by entering:
You can then switch to your user with:
The next thing to do is to ensure that when you launch elementary, you’re doing so as user and not root (which is advisable). 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 out of the box 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 be root for this one. In the terminal as root 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 elementary instance, wait a few seconds (eight is the official line from Microsoft), and then when you relaunch you should be ready to go, already logged in as user.
Alternatively, if you’re using Windows Terminal, open theSettings, find your Linux Mint install in the sidebar, and then in thecommand linebox ensure this command is stored:
This will have the same effect once closed down and restarted. Setting up a wsl.conf file is preferable, though, as it ensures you’re always entering as user and can also store additional settings for your distro.
You’ll also find a number of fairly basic functions and apps that don’t seem to be installed (at least in the build at the time of writing). For example, I had to install the Nano text editor, Git, and wget in the course of setting up elementary OS. Those are three you should definitely add and all are available in the apt repository.
Using the bash shell with elementary OS on WSL
For whatever reason, ElementaryWSL sets up and loads into the sh shell, not the more common bash. The sh shell is actually a legacy tool, and you don’t really want to use it. You can get into a more recognizable bash environment simply by entering
in the terminal, but that’s going to get tedious. So we need to set it up to do it for us.
Note, these steps can also apply to other shells such as Fish or zsh, but we’re using bash for the purposes of this guide as it’s already installed. There are two things you can do.
The first is to use the
command which, as you may guess,changesshell. Enter
into the terminal followed by your password. When prompted enter
as your choice and hitEnter. Close down your instance, give it the eight seconds, then next time you load it up you’ll be in the bash shell instead.
Alternatively, if you use Windows Terminal you can simply instruct elementary OS to go into bash as it loads. In the settings, underCommand lineon the general tab ensure the box reads:
This is a quick fix, but the
method is recommended. And naturally, the course of action for anyone using a different terminal application.
That’s all there is to it, and elementary OS is now set up on WSL for you to use just like any other you would install through the Microsoft Store.
Additionally, you can run multiple instances of elementary OS on WSL. For each subsequent installation, simply change the name of theelementary.exefile from the top of this guide to something else, then run it again. The new instance will be set up with the changed file name, but it does allow you at least to run multiple instances alongside one another.
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
