README.md 1.4 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
14
### QCOW2 images
At the time of writing we offer two different QCOW2 images. The images are synced to the mirrors under the `images` directory, ex: https://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/index.php/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