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.
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 zshThe 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
| Part | Lives on | Path or setting |
|---|---|---|
| zsh | The server | /usr/bin/zsh |
| Oh My Zsh | The server, per user | ~/.oh-my-zsh |
| Powerlevel10k theme | The server, per user | ~/.oh-my-zsh/custom/themes/powerlevel10k |
| Your prompt settings | The server, per user | ~/.p10k.zsh |
| Plugins | The server, per user | ~/.oh-my-zsh/custom/plugins/ |
| MesloLGS NF font | Your computer | Font 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:
curl -fsSL -o install-omz.sh https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh
less install-omz.sh
sh install-omz.shWhat the script does, according to its source:
- Clones Oh My Zsh into
~/.oh-my-zsh. If a~/.zshrcexists, it asks whether to overwrite it, renames it to~/.zshrc.pre-oh-my-zshand writes a new one withZSH_THEME="robbyrussell"andplugins=(git). - Asks
Do you want to change your default shell to zsh? [Y/n], saves your old shell in~/.shell.pre-oh-my-zshand runschsh, throughsudoif you can sudo, so expect a password prompt. At the end it starts zsh. --unattendedskips both questions (an existing~/.zshrcis 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 withchsh -s "$(command -v zsh)"(the block at the top runs it throughsudo); it applies from your next login.
Step 3: install Powerlevel10k and run p10k configure
- 1Clone the theme
zsh git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \ "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" - 2Select it in ~/.zshrc
Change the
ZSH_THEMEline toZSH_THEME="powerlevel10k/powerlevel10k", by hand or with thesedline from the top of this page. - 3Restart zsh
Run
exec zshor log in again. The wizard starts on its own while no Powerlevel10k settings exist; otherwise typep10k 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.fontFamilytoMesloLGS NF. - iTerm2 on macOS:
p10k configureoffers 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:
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-highlightingmust 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 updateupdates it right away. Custom plugins and themes are separate Git clones: update them withgit -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:
rm -f ~/.p10k.zsh
rm -rf "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"
exec zshThe 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:
rm -rf "${XDG_CACHE_HOME:-$HOME/.cache}"/p10k-*(N) "${XDG_CACHE_HOME:-$HOME/.cache}"/gitstatusOh 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.