I have followed the steps successfully as described below https://wiki.alpinelinux.org/wiki/How_to_make_a_custom_ISO_image_with_mkimage

I can add a package which will be available for apk add when running the live iso. However, I don't know how to install the package into the iso, so that the software is already installed when running the live iso.

  • have you edited the apks="$apks ... inside the mkimg profile script to make you package available during the live image run?
    – user34720
    Jun 13, 2017 at 16:37
  • yes I did. Indeed, it makes the packages available during the live image run for apk add. But they are not installed. For example, I'd like to have vim in the live system straight after booting. Jun 13, 2017 at 21:25

1 Answer 1


You will need to make a custom overlay before building the the iso.

You have an example in the aports repo which is scripts/genapkovl-dhcp.sh. Copy that file into genapkovl-mycustomiso.sh (same as mkimg.mycustomiso.sh)

The important part is to put the name of your package (ie: vim) in the /etc/apk/world file.

mkdir -p "$tmp"/etc/apk
makefile root:root 0644 "$tmp"/etc/apk/world <<EOF

also make sure to keep the rc_add lines (if you make your own overlay this symlinks are not added by default)

Then vim will be ready to use from boot, and also will be copied to disk if you make a hard-disk install.

  • In addition to the instructions mentioned above, also don't forget to reference your overlay in your mkimg.mycustomiso.sh script by adding apkovl="genapkovl-myoverlay.sh" in your profile function.
    – Zebaz
    Nov 15, 2018 at 18:24

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .