Your company here — click to reach over 10,000 unique daily visitors

pacstrap - Man Page

install packages to the specified new root directory

Examples (TL;DR)


pacstrap [options] root [packages...]


pacstrap is designed to create a new system installation from scratch. The specified packages will be installed into a given directory after setting up some basic mountpoints. By default, the host system’s pacman signing keys and mirrorlist will be used to seed the chroot.

If no packages are specified to be installed, the base metapackage will be installed.


-C <config>

Use an alternate config file for pacman.


Use the package cache on the host, rather than the target.


Skip pacman dependency checks.


Avoid copying the host’s pacman keyring to the target.


Prompt for package confirmation when needed (run interactively).


Initialize an empty pacman keyring in the target (implies -G).


Avoid copying the host’s mirrorlist to the target.


Run in unshare mode. This will use unshare(1) to create a new mount and user namespace, allowing regular users to create new system installations.


Copy the host’s pacman config to the target.


Use pacman -U to install packages. Useful for obtaining fine-grained control over the installed packages.


Output syntax and command line options.

See Also



Bugs can be reported on the bug tracker https://bugs.archlinux.org in the Arch Linux category and title prefixed with [arch-install-scripts] or via arch-projects@archlinux.org.


  • Dave Reisner <dreisner@archlinux.org>
  • Eli Schwartz <eschwartz@archlinux.org>

For additional contributors, use git shortlog -s on the arch-install-scripts.git repository.