On Ubuntu, Fedora, Debian, or Arch, run
curl up.pash.ndr.md | sh to get PaSh up and running.
If on other environments or prefer manual setup, there are essentially three steps required to set PaSh up: 1. Clone repo:
git clone --depth 1 firstname.lastname@example.org:binpash/pash.git 2. Run
setup-pash.sh 3. Export
PASH_TOP and, optionally, add it to your
Most scripts support a
--help flag that documents their options. These three steps are described in detail below, depending on the environment.
The following steps clone the repo, set up dependencies (e.g., compilers), and then build PaSh:
These scripts have been tested on Ubuntu, Fedora, Debian, and Arch.
Use the system’s package manager to install the following packages (some of which might already be installed in your system):
automake bc bsdmainutils curl gcc git libffi-dev libtool locales locales-all m4 netcat-openbsd pkg-config python python3 python3-pip python3-setuptools python3-testresources sudo wamerican-insane wget
Then clone the PaSh repository and run
setup-pash.sh as follows:
As noted at the end of
setup-pash.sh, make sure you set
PASH_TOP pointing to the absolute path of the directory
pa.sh resides (you can optionally place that in your
If Docker is available, PaSh can be used as part of a Docker container. Depending on the setup, PaSh running on Docker may or may not be able to exploit all available hardware resources. There are two main options for setting up PaSh on Docker:
Pull from DockerHub (Major Releases): To
pull the docker image from Docker Hub, run:
We refresh this image (as well as other images) on every major release.
Build Image (Latest Commit): To build the latest Docker container, run
docker build in scripts/docker:
In the last line, replace
debian to get the corresponding base.
To run the container:
PaSh can be found in the container’s
/opt/pash directory, so run
cd pash; git pull to fetch the latest updates. More information in the pash-on-docker guide.