NAME

       alpine-chroot-install - bootstrap an Alpine Linux chroot

SYNOPSIS

       alpine-chroot-install -d /directory [options]

DESCRIPTION

       This  script  installs  Alpine Linux into a chroot and optionally sets up qemu-user and binfmt to emulate
       different architecture (e.g. armhf).

OPTIONS AND ENVIRONMENT VARIABLES

       -a ARCH
              CPU architecture for the chroot. If not set, then it's the same as  the  host's  architecture.  If
              it's  different  from  the host's architecture, then it will be emulated using qemu-user. Options:
              x86_64, x86, aarch64, armhf, armv7, ppc64le, riscv64, s390x.

       -b ALPINE_BRANCH
              Alpine branch to install (default is latest-stable).

       -d CHROOT_DIR
              Absolute path to the directory where Alpine chroot should be installed; Debian's version  of  this
              script requires giving this explicitly -- such as -d /alpine

       -i BIND_DIR
              Absolute  path  to the directory on the host system that should be mounted on the same path inside
              the chroot (default is PWD, if it's under /home, or none).

       -k CHROOT_KEEP_VARS
              Names of the environment variables to pass from the host environment into  chroot  by  the  enter-
              chroot  script.  Name  may  be  an  extended  regular  expression.  Default: ARCH CI QEMU_EMULATOR
              TRAVIS_.*.

       -m ALPINE_MIRROR
              URI of the Aports mirror to fetch packages from (default is http://dl-cdn.alpinelinux.org/alpine).

       -p ALPINE_PACKAGES
              Alpine packages to install into the chroot (default is build-base ca-certificates ssl_client).

       -r EXTRA_REPOS
              Alpine repositories to be added to /etc/apk/repositories (main and community  from  $ALPINE_MIRROR
              are always added).

       -t TEMP_DIR
              Absolute path to the directory where to store temporary files (defaults to `mktemp -d`).

       -h     Show this help message and exit.

       -v     Print version and exit.

       APK_TOOLS_URI
              URL      of      apk.static     to     download.     Default     is     x86_64     binary     from
              https://gitlab.alpinelinux.org/alpine/apk-tools/-/packages.

       APK_TOOLS_SHA256
              SHA-256 checksum of $APK_TOOLS_URI.

       Each option can be also provided by environment variable. If both option and variable  is  specified  and
       the option accepts only one argument, then the option takes precedence.

AFTER INSTALL

       This  tool  also creates script "enter-chroot" inside the chroot directory, that may be used to enter the
       chroot environment. That script do the following:

              1. saves environment variables specified by $CHROOT_KEEP_VARS and PWD,

              2. chroots into $CHROOT_DIR,

              3. starts clean environment using "env -i",

              4. switches user and simulates full login using "su -l",

              5. loads saved environment variables and changes directory to saved PWD,

              6. executes specified command or "sh" if not provided.

       Example:
       sudo alpine-chroot-install -d /alpine -p build-base -p cmake
       /alpine/enter-chroot -u $USER ./build

Alpine Linux                                       2022-07-22                           alpine-chroot-install(8)