From 449118a8520903837ed2957c24abe8d830b20f42 Mon Sep 17 00:00:00 2001 From: Christian Rebischke Date: Wed, 10 May 2017 12:55:08 +0200 Subject: added README --- README.md | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 56 insertions(+), 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index 06d1aa2..8fba1c2 100644 --- a/README.md +++ b/README.md @@ -1 +1,56 @@ -# arch-boxes \ No newline at end of file +# arch-boxes + +Arch-boxes provides automated builds of the Arch Linux releases for +different providers and post-processors. Check the providers or post-processor sections if you want to know +which are currently supported. + +## Dependencies + +You'll need the following dependencies: + +* packer (for basic usage) +* vagrant (for vagrant images) +* qemu (for libvirt provider support) +* virtualbox (for virtualbox support) + +## How to start the build process + +On Arch Linux: + +`packer-io build vagrant.json` + +On any other System: + +`packer build vagrant.json` + +**Note:** this is because of the name conflict with the AUR-Helpertool +`packer` on Arch linux. + +## providers + +* virtualbox-iso +* qemu/libvirt + +## post-processors + +* vagrant + +## Troubleshooting + +### Parallel build fails +If the parallel build fails this is mostly because the KVM device is +already occupied by a different provider. You can use the build option +`parallel=false` for building the images in a queue instead of parallel. +But don't be surprised that that the build process will take longer. Any +other option is to disable KVM support for all other providers except +one. + +Start `packer` with `-parallel=false`: + +On Arch Linux: + +`packer-io build -parallel=false vagrant.json` + +On any other system: + +`packer build -parallel=false vagrant.json` -- cgit v1.2.3