Skip to content

Latest commit

 

History

History
74 lines (52 loc) · 2.69 KB

README.md

File metadata and controls

74 lines (52 loc) · 2.69 KB
Raw

Installation

On Ubuntu, Fedora, Debian, or Arch, run the following to get PaSh up and running.

wget https://raw.githubusercontent.com/binpash/pash/main/scripts/up.sh
sh up.sh
export PASH_TOP="$PWD/pash/"
## Run PaSh with echo hi
"$PASH_TOP/pa.sh" -c "echo hi"

If on other environments or prefer manual setup, there are essentially three steps required to set PaSh up:

  1. Clone repo: git clone [email protected]:binpash/pash.git
  2. Run distro-deps.sh (with sudo) and setup-pash.sh
  3. Export PASH_TOP and, optionally, add it to your PATH

Most scripts support a --help flag that documents their options. These three steps are described in detail below, depending on the environment.

Quick Jump: Clone & Setup | Manual Setup | Docker Setup | Windows using WSL :

Clone & Setup

The following steps clone the repo, set up dependencies (e.g., compilers), and then build PaSh:

git clone [email protected]:binpash/pash.git
./pash/scripts/distro-deps.sh
./pash/scripts/setup-pash.sh

These scripts have been tested on Ubuntu, Fedora, Debian, and Arch.

Docker Setup

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:

docker pull binpash/pash

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:

git clone [email protected]:binpash/pash.git
cd pash/scripts/docker/
docker build -f ./ubuntu/Dockerfile -t "pash:latest" .

In the last line, replace ubuntu with fedora or debian to get the corresponding base.

To run the container:

docker run --name pash-play -it pash:latest

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.

Windows using WSL

To run PaSh on windows without Docker, install WSL. A short tutorial is included in the contributing guide.