Optimized Alpaquita Linux images for OpenStack and Proxmox environments
Explore the docs »
🐛 Report Bug
·
💡 Request Feature
This project provides optimized Alpaquita Linux images specifically designed for cloud environments, including OpenStack and Proxmox platforms. Alpaquita Linux is a lightweight, security-focused distribution offering both glibc and musl libc variants.
Our build process downloads the official Alpaquita Linux qcow2 images directly from Bell-SW's repository and customizes them using libguestfs tools (virt-customize) to ensure seamless cloud integration. The customization process includes:
- ☁️ Cloud-init integration: Full cloud-init support with OpenStack and ConfigDrive datasources
- 📦 Essential cloud packages: Installation of cloud-init, qemu-guest-agent, SSH server, and network tools
- 🖥️ Console access: Serial console configuration for remote management
- ⚙️ Service automation: Automatic startup of essential services (SSH, DHCP, guest agent)
- 💾 Storage optimization: Image sparsification and compression for efficient deployment
- 🪶 Lightweight: Minimal footprint optimized for cloud deployments
- 🔒 Security-focused: Regular security updates and hardened configuration
- 🌐 Cloud-native: Full cloud-init support for automated provisioning
- 🔄 Dual variants: Available in both glibc and musl libc versions
- 🤖 Automated builds: Images are automatically built and updated via GitHub Actions
Images are automatically built and released when new Alpaquita Linux versions are available from the official Alpaquita Linux repository (glibc variant and musl variant). The CI/CD pipeline ensures fresh images with the latest security updates and cloud optimizations.
-
Set your OpenStack environment variables
-
Download the latest image from the 📥 repository page
-
Upload image to your OpenStack environment
For GLIBC:
openstack image create --disk-format=qcow2 --container-format=bare --file alpaquita-<VERSION>-glibc-x86_64.qcow2 'Alpaquita Linux Stream (glibc)'
For MUSL:
openstack image create --disk-format=qcow2 --container-format=bare --file alpaquita-<VERSION>-musl-x86_64.qcow2 'Alpaquita Linux Stream (musl)'
- Download the latest image from the 📥 repository page
- Copy the image to your Proxmox storage:
scp alpaquita-<VERSION>-<VARIANT>-x86_64.qcow2 root@proxmox-host:/var/lib/vz/template/iso/- Create a new VM using the uploaded image:
<
7C8B
span class="pl-c"># Create VM with cloud-init support
qm create <VMID> --name alpaquita-template --memory 1024 --cores 2 --net0 virtio,bridge=vmbr0
# Import the disk
qm importdisk <VMID> alpaquita-<VERSION>-<VARIANT>-x86_64.qcow2 <STORAGE>
# Configure the VM
qm set <VMID> --scsihw virtio-scsi-pci --scsi0 <STORAGE>:vm-<VMID>-disk-0
qm set <VMID> --boot c --bootdisk scsi0
qm set <VMID> --ide2 <STORAGE>:cloudinit
qm set <VMID> --serial0 socket --vga serial0- Configure cloud-init settings through the Proxmox web interface or CLI:
# Example cloud-init configuration
qm set <VMID> --ciuser alpaquita --cipassword <PASSWORD>
qm set <VMID> --sshkeys ~/.ssh/authorized_keys
qm set <VMID> --ipconfig0 ip=dhcpContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! ⭐Thanks again!
- 🍴 Fork the Project
- 🌿 Create your Feature Branch (
git checkout -b feature/AmazingFeature) - 💾 Commit your Changes (
git commit -m 'Add some AmazingFeature') - 📤 Push to the Branch (
git push origin feature/AmazingFeature) - 🔀 Open a Pull Request
Distributed under the GPL-2.0 License. See LICENSE for more information.
Kevin Allioli - 🐦 @NetArchitect404 - 📧 kevin@netarch.cloud
Project Link: 🔗 https://github.com/open-img-cloud/alpaquita-linux