path: root/
diff options
authorChristian Rebischke <>2017-05-10 12:55:08 +0200
committerChristian Rebischke <>2017-05-10 12:55:08 +0200
commit449118a8520903837ed2957c24abe8d830b20f42 (patch)
treee005a77291912815e6e33ca0ee1426d981622ad9 /
parentb28a3426f492e3cd2451e1e3b71b18c21f2732bd (diff)
added README1.0
Diffstat (limited to '')
1 files changed, 56 insertions, 1 deletions
diff --git a/ b/
index 06d1aa2..8fba1c2 100644
--- a/
+++ b/
@@ -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
+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`