Automated installation of linux distros on removable drive / expansion card with or without luks / full disk encryption: arch, artix, gentoo, funtoo, nixos, alpine, void, kiss. multiboot / dualboot

z.z / AUNIX · GitLab

here’s a project i’ve been using for linux installations, since a long time now
Reason for sharing this are some topics showing interest in the following :

  • automated installs
  • installations on removable drive/expansion card
  • full disk encryption
  • multiboot …


  • be sure go through the README thoroughly, before every use ( as it may change with time )
  • yes, some prior knowledge is definitely needed to follow it
  • before installing any distro, going through it’s documentation is recommended & distro specific queries shall be raised in their specific community/forum


  • this project is not perfect by any means & may or may not work depending on external factors
  • the AIM is just to provide a bootable system, from there onwards users are on their own with their own choices
  • one of the limitation is being BTRFS only. No other format is supported
  • numerous distributions can be installed on a single volume/partition, depending on the size of it
  • any installed distro OR Live image can be used to install any of the available distros on internal or external drive, after satisfying the required dependencies


  • make sure os-prober is installed during the installation process
  • To avoid confusions, it’s recommended to use same FAT32 partition for both windows & linux bootloaders
    • if thats not the case, mount all the partitions/volumes containing bootloaders & update GRUB according to README
  • incase of multibooting with windows
    • its recommended to install windows before installing any other OS, else things may go wrong
    • still, incase windows is installed after installation of a distribution using the script, then simply chroot (instructions provided on README) into the installed distro with any linux live image, then reinstall & update GRUB according to README
grub-install /dev/<disk> # replace <disk> with name of the specific device
grub-mkconfig >> /fat/grub/grub.cfg # update grub config
1 Like