greyltc / docker-archlinux

Baseline Arch Linux Docker image
GNU General Public License v2.0
49 stars 6 forks source link
archlinux docker docker-image

Build Container

docker-archlinux

Minimal Arch Linux docker image with trustable, traceable & inspectable origin

Intro

This project contains a script, build-root.sh, which uses a slightly modified Arch bootstrapping script from this project to create an Arch Linux root filesystem archive suitable for use in a Docker container.

The filesystem used in the greyltc/archlinux container on the Docker registry is an asset attached to each of the releases for this repo. Feel free to inspect it to prove to yourself that it's safe before using it in your project!

Usage

Use docker to pull the latest trustable, AUTOMATED BUILD prebuilt image:

docker pull ghcr.io/greyltc/archlinux
# from https://github.com/greyltc/docker-archlinux/pkgs/container/archlinux

or

docker pull greyltc/archlinux
# from https://hub.docker.com/r/greyltc/archlinux

Building

You can use docker to build this container yourself.

From a release asset

You can fetch a docker build context from a release asset and use that to build the container.

  1. Build your baseline Arch Linux docker image
    docker build --tag arch-localbuild https://github.com/greyltc/docker-archlinux/releases/download/v20240129.0.240/docker-archlinux-x86_64.tar.xz
  2. Inspect the container
    docker run --interactive --tty arch-localbuild bash

    From scratch

    You can use the scripts in this repo to build this container from scratch.

  3. Install dependencies
    Use your favorite Linux distro's package manager to install the following commands/packages: fakechroot, fakeroot, chroot, xz, coreutils, wget, sed, gawk, tar, gzip, git, docker, bash, zstd
  4. Clone repo
    git clone https://github.com/greyltc/docker-archlinux.git
    cd docker-archlinux
  5. Make a build context
    ./build-root.sh x86_64 out
  6. Build your baseline Arch Linux docker image
    docker build --tag arch-localbuild out/x86_64
  7. Inspect the container
    docker run --interactive --tty arch-localbuild bash