pmbootstrap/Installation
pmbootstrap runs on pretty much any Linux distribution with python3, openssl and git installed. It uses Alpine Linux chroots internally to avoid installing software on the host machine. If you don't run Linux on your PC, see #Other operating systems.
Symlink method
git clone https://gitlab.postmarketos.org/postmarketOS/pmbootstrap.git cd pmbootstrap mkdir -p ~/.local/bin ln -s "$PWD/pmbootstrap.py" ~/.local/bin/pmbootstrap pmbootstrap --version This should return the version number.
Continue reading at Using pmbootstrap.
Alternative method
git clone https://gitlab.postmarketos.org/postmarketOS/pmbootstrap.git cd pmbootstrap mkdir -p ~/.pmbootstrap cp -r "$PWD"/* ~/.pmbootstrap/ mkdir -p ~/.local/bin ln -s ~/.pmbootstrap/pmbootstrap.py ~/.local/bin/pmbootstrap pmbootstrap --version This should return the version number.
Continue reading at Using pmbootstrap.
Using pip
git clone https://gitlab.postmarketos.org/postmarketOS/pmbootstrap.git cd pmbootstrap pip install . pmbootstrap --version This should return the version number.
Continue reading at Using pmbootstrap.
Troubleshooting
ModuleNotFoundError: No module named tomllib
This error indicates that you are using Python 3.10 or earlier, which does not include the tomllib module in the standard library.
To fix this, install tomli using your Linux distribution's package manager. The package is usually called python3-tomli
Command pmbootstrap not found
If running pmbootstrap gives you a "command not found" error, it likely means ~/.local/bin is not in your PATH.
To fix this, add the following line to ~/.profile (zsh: ~/.zprofile):
PATH="$HOME/.local/bin:$PATH" Or open a new terminal window for the changes to take effect.
Continue reading at Using pmbootstrap.
From a package manager
 | WARNING: Fixed release distributions, i.e. Debian, may freeze pmbootstrap version which can cause issues as we continue changing pmaports. Consider installing it from git if you want the latest features and bug fixes. |
Use the package manager of your distribution to install pmbootstrap:
Alpine Linux, postmarketOS: # apk add pmbootstrap Arch Linux: # pacman -S pmbootstrap Debian: # apt install pmbootstrap Fedora: # dnf install pmbootstrap Void Linux: # xbps-install -S pmbootstrap Gentoo: # emerge -va app-eselect/eselect-repository # eselect repository enable guru # emaint -r guru sync # emerge -va dev-util/pmbootstrap Nix/NixOS # nix run nixpkgs#pmbootstrap Continue reading at Using pmbootstrap.
Other operating systems
Running pmbootstrap on other operating systems than Linux is not supported. If you run another OS, consider setting up a virtual machine with Linux. Some people also made it work with WSL, see the Windows FAQ. But again, it's not officially supported - we recommend getting some sort of Linux install instead and running it there.