README.md 2.27 KB
Newer Older
Christian Rebischke's avatar
Christian Rebischke committed
1
# arch-boxes
2
3
[![CI Status](https://gitlab.archlinux.org/archlinux/arch-boxes/badges/master/pipeline.svg)](https://gitlab.archlinux.org/archlinux/arch-boxes/-/pipelines)

Kristian Klausen's avatar
Kristian Klausen committed
4
Arch-boxes provides several different VM images.
Christian Rebischke's avatar
Christian Rebischke committed
5

Kristian Klausen's avatar
Kristian Klausen committed
6
The images is built daily and released biweekly (via [GitLab CI schedule](https://gitlab.archlinux.org/archlinux/arch-boxes/-/pipeline_schedules)) and synced to the mirrors.
Christian Rebischke's avatar
Christian Rebischke committed
7

Kristian Klausen's avatar
Kristian Klausen committed
8
## Images
9
10

### Vagrant
Kristian Klausen's avatar
Kristian Klausen committed
11
Vagrant images for the VirtualBox and Libvirt provider are released to [Vagrant Cloud](https://app.vagrantup.com/archlinux/boxes/archlinux).
12

Kristian Klausen's avatar
Kristian Klausen committed
13
### QCOW2 images
14
At the time of writing we offer two different QCOW2 images. The images are synced to the mirrors under the `images` directory, ex: https://geo.mirror.pkgbuild.com/images/.
Kristian Klausen's avatar
Kristian Klausen committed
15

Kristian Klausen's avatar
Kristian Klausen committed
16
17
#### Basic image
The basic image is meant for local usage and comes preconfigured with the user `arch` (pw: `arch`) and sshd running.
18

Kristian Klausen's avatar
Kristian Klausen committed
19
#### Cloud image
20
The cloud image is meant to be used in "the cloud" and comes with [`cloud-init`](https://cloud-init.io/) preinstalled. For tested cloud providers and instructions please see the [ArchWiki's Arch Linux on a VPS page](https://wiki.archlinux.org/title/Arch_Linux_on_a_VPS#Official_Arch_Linux_cloud_image).
21
22
23
24

## Development

### Dependencies
Christian Rebischke's avatar
Christian Rebischke committed
25
26
You'll need the following dependencies:

27
* qemu
28
* libisoburn
Christian Rebischke's avatar
Christian Rebischke committed
29

30
### How to build this
Kristian Klausen's avatar
Kristian Klausen committed
31
The official builds are done in our Arch Linux GitLab CI and can be built locally by running:
Christian Rebischke's avatar
Christian Rebischke committed
32

33
    ./build-host.sh
Kristian Klausen's avatar
Kristian Klausen committed
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# Releases

Every release is signed by our CI with the following key:
```
-----BEGIN PGP PUBLIC KEY BLOCK-----

mDMEYpOJrBYJKwYBBAHaRw8BAQdAcSZilBvR58s6aD2qgsDE7WpvHQR2R5exQhNQ
yuILsTq0JWFyY2gtYm94ZXMgPGFyY2gtYm94ZXNAYXJjaGxpbnV4Lm9yZz6IkAQT
FggAOBYhBBuaFphKToy0SHEtKuC3i/QybG+PBQJik4msAhsBBQsJCAcCBhUKCQgL
AgQWAgMBAh4BAheAAAoJEOC3i/QybG+P81YA/A7HUftMGpzlJrPYBFPqW0nFIh7m
sIZ5yXxh7cTgqtJ7AQDFKSrulrsDa6hsqmEC11PWhv1VN6i9wfRvb1FwQPF6D7gz
BGKTiecWCSsGAQQB2kcPAQEHQBzLxT2+CwumKUtfi9UEXMMx/oGgpjsgp2ehYPBM
N8ejiPUEGBYIACYWIQQbmhaYSk6MtEhxLSrgt4v0MmxvjwUCYpOJ5wIbAgUJCWYB
gACBCRDgt4v0Mmxvj3YgBBkWCAAdFiEEZW5MWsHMO4blOdl+NDY1poWakXQFAmKT
iecACgkQNDY1poWakXTwaQEAwymt4PgXltHUH8GVUB6Xu7Gb5o6LwV9fNQJc1CMl
7CABAJw0We0w1q78cJ8uWiomE1MHdRxsuqbuqtsCn2Dn6/0Cj+4A/Apcqm7uzFam
pA5u9yvz1VJBWZY1PRBICBFSkuRtacUCAQC7YNurPPoWDyjiJPrf0Vzaz8UtKp0q
BSF/a3EoocLnCA==
=APeC
-----END PGP PUBLIC KEY BLOCK-----
```