44

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?

Braiam
  • 35,991
toryan
  • 707

2 Answers2

55

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
Gilles 'SO- stop being evil'
  • 829,060
  • Thanks for this info but this seemed to simply fail silently for me on Ubuntu 20.04.4 LTS. Not sure why. – Luke Sheppard Jun 21 '22 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. – Gilles 'SO- stop being evil' Jun 22 '22 at 06:59
14

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

llua
  • 6,900