Installation

As psh was initially build as a simple install script for zsh, the focus lays on an easy installation process - while still being powerfull enough to generate huge and personalized .zshrc's. While the installation process is straight forward . only Linux distributions that ship with apt as package manager are currently compatible.

Quick install

The quick install is a great choice with you don't have many time for the installation. Just check if your system is compatible with psh and run the below command. If you have an fork of psh, replace the GitHub repository URL with the one of your repository!

Short explaination what the following command does:

• It is not just one command, its seven commands chained together!
• It will check for updates apt update and then install them apt upgrade.
• It will install git.
• It will clone this repository.
• It will change into the directory that has been created while cloning this repository.
• It will make the install.sh script executable
• It will execute the install.sh script
• The installer will guide you through the standard installation process

Copy this command and execute it to quickly install psh:

sudo apt update && sudo apt upgrade && sudo apt install git && git clone https://github.com/pascal-zarrad/psh.git && cd psh && chmod +x install.sh && ./install.sh

If you want further information about the installation, read the full guide.

Normal installation

The normal installation process is using the same commands as the quick install, but with further explaination. Use the following concatenated command to ensure that git is installed.

sudo apt update && sudo apt upgrade && sudo apt install git

Clone this repo

Now clone this repository to collect all required installation files.

git clone https://github.com/pascal-zarrad/psh.git

Go into folder & fix permissions

Now go into the cloned folder and make the install.sh executable.

cd psh && chmod +x install.sh

Finally, install

Now execute the install script.

./install.sh

A note on the Windows subsystem for Linux

The Windows subsystem for Linux (WSL 1) has by default some permission issues when used with git. After launching zsh for the first time, you will encounter an warning from compinit, simply accept it and run the fix-wsl.sh. This script will fix the permissions of all antigen bundles located at ~/.antigen/.