I made a bad choice when configuring Zsh the first time around, so now I would like to run the configuration wizard (the thing that runs the first time you log in) again. How do I do this?

2 Answers 2


The wizard is provided by the function zsh-newuser-install.

To run it again, make a backup of your .zshrc (because there's a small risk that zsh-newuser-install will mess up your manual configuration), then run

autoload -U zsh-newuser-install
zsh-newuser-install -f
  • Thanks for this info but this seemed to simply fail silently for me on Ubuntu 20.04.4 LTS. Not sure why. Jun 21, 2022 at 18:07
  • @LukeSheppard Works for me on Ubuntu 20.04. Try running set -x first and look at the trace (which may be very long) to see if there are any clues. If you can't figure it out, post a new question with the full trace. Jun 22, 2022 at 6:59

autoload -Uz zsh-newuser-install; zsh-newuser-install -f The wizard is just a function that you can call at any time.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .