alpimager

Build custom Alpine Linux images with Docker.

Go CI

introduction video

Overview

This projects builds custom Alpine Linux images with the alpine-make-vm-image utility, but it uses Docker and a simplified interface so that it can run easily on systems other than Alpine Linux that support Docker, such as for example macOS.

Installation

Linux and macOS binaries are available on GitHub Releases. Windows is no longer supported since WSL2, the new Docker backend in Windows, uses a Kernel without nbd support; if just want a quick Alpine VM on Windows, I recommend using Alpine WSL instead until Microsoft resolve the issue.

Usage

See testdata for example files.

% alpimager -help
Usage of alpimager:
  -debug
        Enable debugging output
  -output string
        Output image file (default "alpine.qcow2")
  -packages string
        Package list file (default "packages.txt")
  -repositories string
        Repository list file (default "repositories.txt")
  -script string
        Setup script file (default "setup.sh")

License

alpimager (c) 2020 Felix Pojtinger

SPDX-License-Identifier: AGPL-3.0