Installing pkgx

There are quite a few ways to install pkgx but this is our recommendation:

brew install pkgx || curl https://pkgx.sh | sh

Complete Installation Method Listing

Homebrew

brew install pkgx

cURL Installer

Our installer both installs and upgrades pkgx:

curl -fsS https://pkgx.sh | sh

Wanna read that script before you run it? [github.com/pkgxdev/setup/installer.sh][installer]

Download Manually

pkgx is a standalone binary, so you can just download it directly:

# download it to `./pkgx`
curl -o ./pkgx \
   --compressed --fail --proto '=https' \
   https://pkgx.sh/$(uname)/$(uname -m)

# install it to `/usr/local/bin/pkgx`
sudo install -m 755 pkgx /usr/local/bin

For your convenience we provide a .tgz so you can one-liner that:

curl -Ssf https://pkgx.sh/$(uname)/$(uname -m).tgz | sudo tar xz -C /usr/local/bin

You can also download straight from GitHub Releases (you’ll likely need to unquarantine the downloaded binary).

Cargo

cargo install pkgx

Docker

docker run -it pkgxdev/pkgx

# or, eg.
docker run pkgxdev/pkgx +python@3.10 node@22 start

Or in your Dockerfile:

FROM pkgxdev/pkgx
RUN pkgx +node@16 npm start

hub.docker.com/r/pkgxdev/pkgx {% endhint %}

GitHub Actions

- uses: pkgxdev/setup@v3

github.com/pkgxdev/setup

`pkgx` makes it easy to consistently use the GNU or BSD versions of core utilities across different platforms—handy for cross-platform CI/CD scripts. eg. `pkgx +gnu.org/coreutils ls`

Arch Linux

If you're on Arch Linux (or any of it's derivatives) you can also use the pkgx AUR (latest released version) or pkgx-git AUR (latest development version, might not be stable).

The AURs are community-maintained and might be out-of-date. Use them with caution.