This set of guides and recommendations is aimed at the use of Alpine for your local servers on physical hardware where you have access to the boot console.

Headless and cloud deployments remain to be added (cloud deployment work is in progress based on Packer, Terraform, and Vault at the time of this writing [June 27, 2022]).

Also not documented here is fully ‘automated’ bare metal installation and configuration; that likely will be added based on these pages, but in another set of guides.

Finally, the semi-data/semi-diskless guides would also work for systems in which one uses a flash device for the OS and OS data (e.g. a system running from a USB flash drive).


  1. Obtain and verify the install media
  2. Write the install image to bootable storage for x86_64/x86 (Alpine Linux wiki) or write the install tarball to your boot disk (e.g. SD card) for the Raspberry Pi
  3. Boot from the install media (Alpine Linux wiki)
  4. Choose install type
    1. Create a semi-data/semi-diskless install
      1. Use modified setup-alpine procedure
      2. Commit LBU
    2. Create an encrypted LVM ‘sys’ aka ‘classic’ install
  5. Reboot
  6. Kernel and hardware notes - hardware specific tweaks & configuration

See also

Important post install configuration

Recommended tweaks and configuration

‘Create Alpine Disk Image’ script by Dermot Bradley (on GitHub)