Run the Zsh first use wizard

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?


Thank you for visiting the Q&A section on Magenaut. Please note that all the answers may not help you solve the issue immediately. So please treat them as advisements. If you found the post helpful (or not), leave a comment & I’ll get back to you as soon as possible.

Method 1

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

Method 2

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

All methods was sourced from or, is licensed under cc by-sa 2.5, cc by-sa 3.0 and cc by-sa 4.0

0 0 votes
Article Rating
Notify of
Inline Feedbacks
View all comments