A Complete Beginner's Guide to Zsh Setup on WSL
Niloy Majumder
bluefloyd • June 23rd 2025
If you're a new developer using WSL (Windows Subsystem for Linux) and want a terminal that feels fast, looks amazing, and helps you work smarter, setting up zsh with a few enhancements can completely change your workflow. In this blog post, I'll walk you through my complete zsh setup on WSL, step-by-step.
🧰 Setup
Zsh (with Oh My Zsh)
Powerlevel10k theme
Plugins: Autosuggestions & Syntax Highlighting
Nerd Fonts
GUI Terminal & Dircolors themes
Useful dev aliases
Before diving into the ZSH setup, let's make sure you have WSL (Windows Subsystem for Linux) with Ubuntu installed on your system.
Verify WSL and Ubuntu Installation
Open your terminal (Command Prompt or PowerShell) and run the following command to check if WSL is installed:
wsl --list --verbose
If Ubuntu is installed properly, you should see an output similar to this:
NAME STATE VERSION
* Ubuntu Running 2
If you don’t have WSL or Ubuntu set up yet, you can install them by following Microsoft’s official guide here: Install WSL
Now get back into the main process.
🛠️ Step-by-Step Zsh Setup on WSL (Ubuntu)
1. Install Zsh & Oh My Zsh
sudo apt update
sudo apt install zsh -y
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
2. Set Zsh as Your Default Shell
chsh -s $(which zsh)
You may need to restart WSL for the change to apply.
3. Install Powerlevel10k Theme
Copy the following into your WSL terminal:
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
Then, edit ~/.zshrc:
ZSH_THEME="powerlevel10k/powerlevel10k"
Run:
source ~/.zshrc
p10k configure
For more theme
4. Install Nerd Font (for Icons)
Powerlevel10k needs a Nerd Font. I recommend MesloLGS NF:
Download here: https://github.com/romkatv/powerlevel10k#manual-font-installation
Install on Windows
Set it as the font in Windows Terminal > Settings > Ubuntu profile > Appearance > Font Face
5. Install Plugins
I didn't install so many plugins as I don't need many of them, so I only used plugins for editing text and a couple of plugins for formatting. However, if you need to install more plugins you can visit the list of extensions from here Zsh Plugins
Autosuggestions:
git clone https://github.com/zsh-users/zsh-autosuggestions \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
Syntax Highlighting:
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
Add plugins to your ~/.zshrc: Then find the plugins=(...) line and add:
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)
Then reload:
source ~/.zshrc
🎨 Color Scheme (optional): Solarized Dark Dircolors Theme
git clone https://github.com/seebi/dircolors-solarized.git ~/.solarized-dircolors
cp ~/.solarized-dircolors/dircolors.ansi-dark ~/.dircolors
In ~/.zshrc, add:
eval "$(dircolors -b ~/.dircolors)"
Useful Developer Aliases
Add these to the bottom of your ~/.zshrc:
alias ll='ls -la --color=auto'
alias gs='git status'
alias ga='git add .'
alias gc='git commit -m'
alias gp='git push'
alias codehere='code .'
alias open='explorer.exe'
alias desktop='cd /mnt/c/Users/$USER/Desktop'
Then reload the zsh config file:
source ~/.zshrc
This setup turns your terminal into a beautiful, fast, and powerful command center for development. This is my first tech blog, since I'm also a newbie, trying to explore things, get ideas, and share this with the world, so I might have some mistakes. Pardon me. Thank you for reading. If you give this setup a try, I’d love to hear your thoughts in the comments!
Subscribe to my newsletter
Read articles from Niloy Majumder directly inside your inbox. Subscribe to the newsletter, and don't miss out.
Written by