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

Windows

irm https://pkgx.sh | iex
# ^^ limited packages so far, list available programs with `pkgx -Q`

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

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 [email protected] node@22 start

Or in your Dockerfile:

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

hub.docker.com/r/pkgxdev/pkgx

GitHub Actions

- uses: pkgxdev/setup@v4

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 thepkgx 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.