by archlinux

archlinux / arch-boxes

Arch-boxes provides automated builds of the Arch Linux releases for different providers and post-pro...

138 Stars 53 Forks Last release: 5 months ago (1.6.0) GNU General Public License v3.0 282 Commits 21 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


CI Status

Arch-boxes provides automated builds of the Arch Linux releases for different providers and formats.



If you're a vagrant user, you can just go to our Vagrant Cloud page and follow the instructions there.

Plain qcow2 image

If you want to use the plain qcow2 image with

or other hypervisors, you can use the nightly qcow2 images we provide. Be advised, however, that our automatic builds are cleaned up after a few days so you can't hard-code a specific image version anywhere.

You can use this snippet to always get the most recent image and check its integrity (you need to install

for this):
most_recent=$(curl -Ls '' | grep cloudimg | grep -vi sha256 | hq a attr href | sed "s|artifacts/file|artifacts/raw|")
curl -LO  "$most_recent"{,.SHA256}
sha256sum -c $(basename $most_recent).SHA256



You'll need the following dependencies:

  • vagrant (for vagrant images)
  • qemu

How to build this

The official builds are done in our Arch Linux GitLab CI.


Development workflow

Merge requests and general development shall be made on the


We have CI in place to build all images even for merge requests.

Release workflow

Releases are done automatically via GitLab CI schedule. No manual intervention is required or desired.

Checking cloud-init support in our qcow2 images:

$ packer build -only=cloud -except=sign config.json
$ cp Arch-Linux-cloudimg-2020-02-24.qcow2 disk.qcow2

Copied from (with minor changes):

$ { echo instance-id: iid-local01; echo local-hostname: cloudimg; } > meta-data

$ printf "#cloud-config\npassword: passw0rd\nchpasswd: { expire: False }\nssh_pwauth: True\n" > user-data

create a disk to attach with some user-data and meta-data (require cdrkit)

$ genisoimage -output seed.iso -volid cidata -joliet -rock user-data meta-data

create a new qcow image to boot, backed by your original image

$ qemu-img create -f qcow2 -b disk.qcow2 boot-disk.qcow2

boot the image and login as 'arch' with password 'passw0rd'

note, passw0rd was set as password through the user-data above,

there is no password set on these images.

$ qemu-system-x86_64 -m 256
-net nic -net user,hostfwd=tcp::2222-:22
-drive file=boot-disk.qcow2,if=virtio
-drive file=seed.iso,if=virtio

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.