pkgx/docs
GitHub
  • Highlights
  • pkgx
    • Installing pkgx
    • Getting Started
    • Scripting
  • The pkgx Ecosystem
    • pkgm
    • dev
    • mash
    • pkgo
  • Appendix
    • FAQ
    • Deeper Dives
      • How pkgx Works: A Conceptual Overview
      • Using pkgx with a C/C++ Pipeline
    • Packaging
      • Contributing Packages
      • API
  • Linktree
    • GitHub
    • Discord
    • 𝕏
Powered by GitBook
On this page
  • Complete Installation Method Listing
  • Homebrew
  • cURL Installer
  • Windows
  • Download Manually
  • Cargo
  • Docker
  • GitHub Actions
  • Arch Linux
Edit on GitHub
  1. pkgx

Installing pkgx

Last updated 1 month ago

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?

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

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

GitHub Actions

- uses: pkgxdev/setup@v4

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

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

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

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

github.com/pkgxdev/setup/installer.sh
GitHub Releases
hub.docker.com/r/pkgxdev/pkgx
github.com/pkgxdev/setup
pkgx AUR
pkgx-git AUR