docs/installing-pkgx.md
There are quite a few ways to install pkgx but this is our recommendation:
brew install pkgx || curl https://pkgx.sh | sh
brew install pkgx
Our installer both installs and upgrades pkgx:
curl -fsS https://pkgx.sh | sh
irm https://pkgx.sh | iex
# ^^ limited packages so far, list available programs with `pkgx -Q`
{% hint style='info' %} Wanna read that script before you run it? github.com/pkgxdev/setup/installer.sh {% endhint %}
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 install pkgx
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
{% hint style='info' %} hub.docker.com/r/pkgxdev/pkgx {% endhint %}
- uses: pkgxdev/setup@v4
{% hint style='info' %} github.com/pkgxdev/setup {% endhint %}
{% hint style='success' %}
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
{% endhint %}
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).
{% hint style='warning' %} The AURs are community-maintained and might be out-of-date. Use them with caution. {% endhint %}