Guides

Oh My Zsh and Powerlevel10k on a Linux server: install, p10k configure, fonts and plugins

Install zsh, Oh My Zsh and the Powerlevel10k theme on a Linux server over SSH: p10k configure, MesloLGS NF fonts, plugins and how to switch back to bash.

Published ~8 min read
On this page

Short answer: install zsh and git on the server, run the Oh My Zsh install script, clone Powerlevel10k into Oh My Zsh’s custom themes folder and set ZSH_THEME="powerlevel10k/powerlevel10k" in ~/.zshrc. The next zsh start opens the p10k configure wizard. The icons come from a font, MesloLGS NF, which belongs on the computer you SSH from, not on the server.

Debian · Ubuntu · as your normal user
sudo apt update && sudo apt install -y zsh git curl
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"
sed -i 's|^ZSH_THEME=.*|ZSH_THEME="powerlevel10k/powerlevel10k"|' ~/.zshrc
sudo chsh -s "$(command -v zsh)" "$USER"
exec zsh

The commands were not run for this guide; they come from ohmyz.sh, the README files of Oh My Zsh, Powerlevel10k and the two plugins on GitHub, and the Oh My Zsh install and uninstall scripts, all read on 11 November 2026.

What runs on the server and what runs on your computer

PartLives onPath or setting
zshThe server/usr/bin/zsh
Oh My ZshThe server, per user~/.oh-my-zsh
Powerlevel10k themeThe server, per user~/.oh-my-zsh/custom/themes/powerlevel10k
Your prompt settingsThe server, per user~/.p10k.zsh
PluginsThe server, per user~/.oh-my-zsh/custom/plugins/
MesloLGS NF fontYour computerFont setting of your terminal or SSH client

SSH only carries text. The server sends the characters of the prompt, and the terminal on your desk draws them with its own font, so a missing icon is fixed on your side. Everything else is per user: setting it up for deploy changes nothing for root.

Step 1: install zsh and pick the user

Debian 12 and 13 and Ubuntu 24.04 and 26.04 all ship zsh 5.9, newer than what both projects ask for: Oh My Zsh prefers 5.0.8 or later, and Powerlevel10k’s FAQ says 5.3 works and 5.4 or later gives fast startup. The installer also needs git and curl or wget.

  • Do this as the user you log in with every day, a sudo user rather than root. Root keeps plain bash, which is the shell you want when something in a dotfile breaks.
  • Keep a second SSH session open while you change login shells, and close it only after a fresh login works.

Step 2: install Oh My Zsh

The install line above downloads the script and runs it with sh; the "" --unattended at its end (the form the Oh My Zsh README gives) stops it from asking questions, so the rest of a pasted block is not read as an answer. To read the script before it runs, download it first:

Linux
curl -fsSL -o install-omz.sh https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh
less install-omz.sh
sh install-omz.sh

What the script does, according to its source:

  • Clones Oh My Zsh into ~/.oh-my-zsh. If a ~/.zshrc exists, it asks whether to overwrite it, renames it to ~/.zshrc.pre-oh-my-zsh and writes a new one with ZSH_THEME="robbyrussell" and plugins=(git).
  • Asks Do you want to change your default shell to zsh? [Y/n], saves your old shell in ~/.shell.pre-oh-my-zsh and runs chsh, through sudo if you can sudo, so expect a password prompt. At the end it starts zsh.
  • --unattended skips both questions (an existing ~/.zshrc is backed up and replaced without asking), leaves the login shell alone and does not start zsh at the end, which suits provisioning scripts. Change the shell yourself with chsh -s "$(command -v zsh)" (the block at the top runs it through sudo); it applies from your next login.

Step 3: install Powerlevel10k and run p10k configure

  1. 1Clone the theme
    zsh
    git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
      "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"
  2. 2Select it in ~/.zshrc

    Change the ZSH_THEME line to ZSH_THEME="powerlevel10k/powerlevel10k", by hand or with the sed line from the top of this page.

  3. 3Restart zsh

    Run exec zsh or log in again. The wizard starts on its own while no Powerlevel10k settings exist; otherwise type p10k configure.

The first questions test what your terminal font can display, and the wizard only offers styles whose symbols render. Then you pick a style (Lean, Classic, Rainbow or Pure) and a few details of that style. The answers go into ~/.p10k.zsh, and the wizard adds an instant prompt block at the top of ~/.zshrc and a line that loads ~/.p10k.zsh at the bottom. Run p10k configure again whenever you want a different look. Updates are a git pull in the theme folder, as the README shows: git -C "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" pull.

Fonts: MesloLGS NF on the computer you SSH from

Powerlevel10k does not require a special font, but the icons and separators need one. The README recommends MesloLGS NF, four files you install on your own computer: MesloLGS NF Regular.ttf, Bold, Italic and Bold Italic. Then point your terminal at MesloLGS NF:

  • Windows Terminal: Settings, your profile, Appearance, Font face. This also covers the OpenSSH client in Windows.
  • VS Code terminal (also Remote SSH): set terminal.integrated.fontFamily to MesloLGS NF.
  • iTerm2 on macOS: p10k configure offers to install the font itself.
  • PuTTY: install the font in Windows, then set Window, Appearance, Font to MesloLGS NF. The README asks for PuTTY 0.75 or later. Other clients work the same way: font installed in the operating system, then chosen in the client’s font settings.

If the icons still show as boxes, the README’s fix is to restart the terminal, install the font and run p10k configure again. An error zsh: character not in range means the server’s locale is not UTF-8; on Debian, sudo dpkg-reconfigure locales sets one up.

Plugins: zsh-autosuggestions and zsh-syntax-highlighting

The two plugins most people add are not part of Oh My Zsh. Clone them into the custom plugins folder and list them in the plugins line:

zsh
git clone https://github.com/zsh-users/zsh-autosuggestions \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestions"
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting"
sed -i 's/^plugins=(git)$/plugins=(git zsh-autosuggestions zsh-syntax-highlighting)/' ~/.zshrc
exec zsh
  • Separate plugin names with spaces. The Oh My Zsh README warns that commas “will break” the line.
  • zsh-syntax-highlighting must be the last plugin loaded, so keep it at the end of the list.
  • Oh My Zsh asks every two weeks by default whether to update itself, and omz update updates it right away. Custom plugins and themes are separate Git clones: update them with git -C FOLDER pull.

Uninstall Powerlevel10k or switch back to bash

Only the theme: set ZSH_THEME="robbyrussell" (the Oh My Zsh default) or another theme, delete the instant prompt block and the ~/.p10k.zsh line from ~/.zshrc, then remove the files, as the Powerlevel10k README lists them:

zsh
rm -f ~/.p10k.zsh
rm -rf "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"
exec zsh

The README asks for a fresh zsh at this point, not source ~/.zshrc. In that new zsh, delete the cache files as its last step; the (N) is zsh syntax, so run it in zsh:

zsh
rm -rf "${XDG_CACHE_HOME:-$HOME/.cache}"/p10k-*(N) "${XDG_CACHE_HOME:-$HOME/.cache}"/gitstatus

Oh My Zsh as a whole: run uninstall_oh_my_zsh. If the installer changed your shell, the script first switches it back to the one saved in ~/.shell.pre-oh-my-zsh (after an --unattended install there is no such file, so use the chsh line below). It then asks for confirmation, deletes ~/.oh-my-zsh, renames ~/.zshrc to ~/.zshrc.omz-uninstalled-DATE and restores ~/.zshrc.pre-oh-my-zsh if there is one.

Just back to bash: chsh -s /bin/bash, then log out and in again. zsh and its files can stay; nothing runs them any more.

Does zsh change anything else on a server?

Less than people fear. zsh reads ~/.zshrc only for interactive shells, so scp, rsync and commands run as ssh host command do not load the theme. Scripts keep running in the shell named on their #! line, and cron and systemd jobs do not use your login shell. What does change is your interactive sessions, including new tmux windows, which start your login shell. If you are setting up a fresh VPS, do the basics in initial server setup first; a nicer prompt is the last step, not the first.

Frequently asked

Is Powerlevel10k still maintained?

Only barely. As of November 2026 its README states that the project has very limited support, that no new features are in the works, that most bugs will go unfixed and that help requests will be ignored. The repository and its install instructions are still online, but do not count on fixes.

Do I need to install the MesloLGS NF font on the server?

No. Over SSH the server only sends text, and your local terminal draws it with its own font. Install MesloLGS NF on the computer you connect from and select it in your terminal, for example under Appearance, Font face in Windows Terminal or terminal.integrated.fontFamily in VS Code.

How do I run the Powerlevel10k configuration wizard again?

Type p10k configure in a zsh session. It asks the same questions as on first start and overwrites ~/.p10k.zsh with your new answers. If icons show as boxes, install MesloLGS NF on your computer and restart the terminal before you run it.

How do I go back from zsh to bash?

Run chsh -s /bin/bash and log in again. To remove Oh My Zsh as well, run uninstall_oh_my_zsh: if the installer changed your shell, it switches back to the one it saved at install time, then deletes ~/.oh-my-zsh and restores your earlier ~/.zshrc if there was one.

Related articles

All guides