Prerequisites
To run Pants, you need:
- One of:
- Linux (x86_64 or ARM64)
- macOS (Intel or Apple Silicon, 10.15 Catalina or newer)
- Microsoft Windows 10 with WSL 2
- Internet access (so that Pants can fully bootstrap itself)
See Restricted Internet access for instructions.
System-specific notes
Linux
On Ubuntu you may need to run:
apt install -y python3-dev python3-distutils.
Pants for Linux is currently distributed as a manylinux wheel. Alpine Linux is not covered by manylinux (it uses MUSL libc while manylinux requires glibc), so at present Pants will not run on Alpine Linux.
If you need to run Pants on Alpine, let us know, so we can prioritize this work. Meanwhile, you can try building Pants yourself on Alpine.
Pants 2.16 will be distributed for Linux x86_64 and ARM64. Earlier versions are only distributed for Linux x86_64.
If you need to run an earlier version of Pants on ARM, you can try building Pants yourself on that platform.
macOS
If running Pants inside a Docker container on an Apple Silicon machine you may need to set --no-watch-filesystem --no-pantsd. This is because notifications on native macOS files aren't mirrored over to the virtualized Linux system.
We don't recommend setting this permanently, as these options are crucial for performance when iterating. Instead, you may want to look at the new Environments feature, that lets Pants run natively on macOS but selectively invoke processes in a Docker container.
Microsoft Windows
Pants runs on Windows 10 under the Windows Subsystem for Linux (WSL):
- Follow these instructions to install WSL 2.
- Install a recent Linux distribution under WSL 2 (we have tested with Ubuntu 20.04 LTS).
- Run
sudo apt install unzip python3-dev python3-distutils python3-venv gccin the distribution. - You can then run Pants commands in a Linux shell, or in a Windows shell by prefixing with
wsl.