Skip to content


Basic Alpine Linux setup

Make sure the server to be provisioned is set to UEFI mode and boot over PXE (IPv4). To install:

Main install

  1. Boot over PXE, the correct flavor should be pre-selected (lts for bare metal, virt for a VM).
  2. Log in as root and run:
    1. apk add vlan (to pre-install VLAN support for ifupdown)
    2. mkdir /etc/udhcpc && echo 'NO_GATEWAY="lan"' > /etc/udhcpc/udhcpc.conf (to prevent using the LAN interface for internet access)
  3. Run setup-alpine and follow the prompts:

    1. Choose ie as the keyboard layout and then ie as the variant
    2. Enter the name of the server for the hostname, e.g. napalm
    3. When asked which network interface you'd like to initialize, say done.
    4. Say yes to do manual network config and paste the following (after the section configuring the loopback interface):


      Make sure to change the MAC address to match the LAN interface's MAC, set the hostname appropriately and the public IP address.

      auto lan
      iface lan inet dhcp
          pre-up [ -e /sys/class/net/eth0 ] && (ip addr flush dev eth0 && ip link set dev eth0 down) || true
          pre-up nameif $IFACE 52:54:00:12:34:57
      auto wan
      iface wan inet static
          vlan-raw-device lan
          vlan-id 420
    5. Enter Europe/Dublin for the timezone

    6. Use none for the HTTP proxy
    7. chrony is fine for the NTP client
    8. The default mirror ( is fine
    9. Use openssh for the SSH server
    10. Enter none for the disk
    11. none for where to store configs and apk cache directory
  4. Replace the contents of /etc/apk/repositories with:

    Note the mirror name and Alpine branch (v3.13 in this case). Run apk update after to update the package lists.


  1. Run apk add nfs-utils and rc-update add nfsclient to install NFS and start the client on boot. Run rc-service nfsclient start to start the client now

  2. Install and enable autofs (apk add autofs, rc-update add autofs) and configure the apkovl NFS share:

    1. Replace the contents of /etc/autofs/auto.master with the following:

      /media/autofs /etc/autofs/auto.shoe --timeout 5
    2. Paste the following into /etc/autofs/auto.shoe:

      lbu -rw shoe.netsoc.internal:/srv/http/apkovl


      autofs is used instead of just putting the mount into /etc/fstab to only mount the share when required and more gracefully handle disconnects

      Run rc-service autofs start to start autofs now.

LBU (Alpine Local Backup)

When running in diskless mode, Alpine Linux overlays configuration from a tar stored on a remote server. In order to update configuration, the system must be configured. In this case the configs will be stored on the boot server via the NFS share set up above.

  1. Configure LBU by editing /etc/lbu/lbu.conf and:

    • Uncomment and set LBU_BACKUPDIR to /media/autofs/lbu/myserver
    • (Optional but recommended) Uncomment and set BACKUP_LIMIT to some value (e.g. 5) in order to keep a number of backups


    If you make a mistake in any of the above steps, just reboot to start over! All changes up to this point exist only in memory!

  2. Save the configuration:

    1. Run lbu status (or lbu st for short) - a big list of files should appear; this is the list of modified files compared to the existing overlay archive
    2. Run lbu include /root/.ssh/authorized_keys to save the SSH public key put in place automatically on boot
    3. Do lbu commit to save the changes (a file myserver.apkovl.tar.gz should now be present in /mnt/lbu/myserver)
    4. Re-run lbu status - nothing should be listed, this means lbu is reading the saved archive and detecting there are no changed files.
    5. Run ln -sf /mnt/lbu/myserver/myserver.apkovl.tar.gz /mnt/lbu/52:54:00:12:34:57.tar.gz (ensuring to insert the correct hostname and MAC address). This will enable the Alpine Linux init script to locate the overlay archive without the hostname on boot.


    Make sure to commit any filesystem changes with lbu commit in future!

Last update: 2021-02-26