https://wiki.alpinelinux.org/w/api.php?action=feedcontributions&feedformat=atom&user=AlrafanaAlpine Linux - User contributions [en]2026-05-06T08:48:25ZUser contributionsMediaWiki 1.40.0https://wiki.alpinelinux.org/w/index.php?title=How_to_make_a_custom_ISO_image&diff=4014How to make a custom ISO image2010-06-26T02:00:23Z<p>Alrafana: typo</p>
<hr />
<div>This document explains how to build a custom ISO image using the alpine-iso scripts.<br />
<br />
First make sure we have the needed tools<br />
{{Cmd|apk add alpine-sdk}}<br />
<br />
Then we clone (or update) the alpine-iso git repository.<br />
{{Cmd|git clone git://git.alpinelinux.org/alpine-iso}}<br />
<br />
The alpine-iso scripts is a simple makefile which you need to feed with a ''<name>.conf.mk'' file and a ''<name>.packages''. <br />
<br />
In the ''<name>.conf.mk'' we specify<br />
<br />
;ALPINE_NAME<br />
:name of iso image<br />
<br />
;ALPINE_VERSION<br />
:(optional) version string. Will default to todays date.<br />
<br />
;KERNEL_FLAVOR<br />
:(optional) either ''grsec'', ''vserver'' or ''pae''. Will default to grsec.<br />
<br />
;MODLOOP_EXTRA<br />
:(optional) Extra kernel module packages for the modloop image. For example: ''dahdi-linux-vserver''<br />
<br />
The ''<name>.packages'' is just a plaintext list of packages that should be included in the iso. You should always add ''alpine-base'' in there or the CD might not be able to boot. The dependencies for the packages will automatically be pulled in.<br />
<br />
== A rescue CD example ==<br />
As an example, let us make a rescue ISO with packages needed for rescue operations. We call it ''alpine-rescue''<br />
<br />
We create the alpine-rescue.conf.mk as follows:<br />
ALPINE_NAME := alpine-rescue<br />
KERNEL_FLAVOR := grsec<br />
MODLOOP_EXTRA :=<br />
<br />
And then the ''alpine-rescue.packages'' as:<br />
alpine-base<br />
bkeymaps<br />
openssh<br />
e2fsprogs<br />
mdadm<br />
lvm2<br />
parted<br />
debootstrap<br />
ntfs-3g<br />
<br />
{{Tip|If you have home-built apk's that you would like to include in the iso you are about to create:<br />
Make sure your developer keys are placed in /etc/apk/keys/<br />
<br />
Learn apk-tools to find your home-built apk's:<br />
{{Cmd|echo "~/.cache/apks" >> /etc/apk/repositories}}<br />
}}<br />
<br />
Make sure the apk index is up to date (so apk finds the packages):<br />
{{Cmd|apk update}}<br />
<br />
We create the ISO image by telling the makefile the profile name. The makefile target is ''iso''.<br />
{{Cmd|<nowiki>make PROFILE=alpine-rescue iso</nowiki>}}<br />
<br />
To generate the sha1 sum we use the ''sha1'' make target.<br />
{{Cmd|<nowiki>make PROFILE=alpine-rescue sha1</nowiki>}}</div>Alrafana