pacstrap - Man Page
install packages to the specified new root directory
Examples (TL;DR)
- Install the
base
package, Linux kernel and firmware for common hardware:pacstrap path/to/new/root base linux linux-firmware
- Install the
base
package, Linux LTS kernel andbase-devel
build tools:pacstrap path/to/new/root base base-devel linux-lts
- Install packages without copy the host's mirrorlist to the target:
pacstrap -M path/to/new/root packages
- Use an alternate configuration file for Pacman:
pacstrap -C path/to/pacman.conf path/to/new/root packages
- Install packages using the package cache on the host instead of on the target:
pacstrap -c path/to/new/root packages
- Initialize an empty
pacman
keyring in the target without copying it from the host:pacstrap -K path/to/new/root packages
- Install packages in interactive mode (prompts for confirmation):
pacstrap -i path/to/new/root packages
- Install packages using package files:
pacstrap -U path/to/new/root path/to/package1 path/to/package2
Synopsis
pacstrap [options] root [packages...]
Description
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.
Options
- -C <config>
Use an alternate config file for pacman.
- -c
Use the package cache on the host, rather than the target.
- -D
Skip pacman dependency checks.
- -G
Avoid copying the host’s pacman keyring to the target.
- -i
Prompt for package confirmation when needed (run interactively).
- -K
Initialize an empty pacman keyring in the target (implies -G).
- -M
Avoid copying the host’s mirrorlist to the target.
- -N
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.
- -P
Copy the host’s pacman config to the target.
- -U
Use pacman -U to install packages. Useful for obtaining fine-grained control over the installed packages.
- -h
Output syntax and command line options.
See Also
Bugs
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.
Authors
- Maintainers:
- Dave Reisner <dreisner@archlinux.org>
- Eli Schwartz <eschwartz@archlinux.org>
For additional contributors, use git shortlog -s on the arch-install-scripts.git repository.