Quick Start with Vagrant¶
Vagrant HOST Steps¶
The following steps are performed on the host that runs Vagrant.
Installing Vagrant and Downloading Armbian¶
First, you’ll need to install Vagrant on your host box. Then you have to choose if you want to run Virtualbox or Libvirt.
Virtualbox¶
Install Virtualbox, then you’ll need to install a plug-in that will enable us to resize the primary storage device. Without it, the default Vagrant images are too small to build Armbian.
Text Only | |
---|---|
1 |
|
Libvirt¶
Installing libvirt is a little bit more complex as you have to install an hypervisor too (like KVM/Qemu but others are available). Discussing about which one choosing and how to install it is out of scope. Once you have libvirt and an hypervisor installed, you’ll need vagrant-libvirt. Finally, you need to tell vagrant to use libvirt and not default to Virtualbox.
Text Only | |
---|---|
1 |
|
Common steps¶
Now we’ll need to install git and clone the Armbian repo. While this might seem obvious, we rely on it being there when we use Vagrant to bring up our guest-build box.
Text Only | |
---|---|
1 2 3 4 5 6 7 8 9 |
|
Armbian Directory Structure¶
Before we bring up the box, take note of the directory structure used by the Armbian build tool. When you read the Vagrantfile (which is in the build/config/templates directory) you’ll see that Vagrant will mount local output and userpatches directories. This is helpful as it enables you to easily retrieve your images from the host once built, and customize the build process.
Creating the Vagrant Guest Box Used to Build¶
Let’s bring the box up. This might take a minute or two depending on your bandwidth and hardware.
Text Only | |
---|---|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
|
Shut down, clean up¶
Wrap up your vagrant box when no longer needed (log out of the guest before running these commands on the host system):
Text Only | |
---|---|
1 2 3 4 5 |
|
Important note¶
It is strongly recommended to halt and restart the Vagrant box after building an image. Check this issue for details.
Vagrant GUEST Steps¶
The following steps are all run on the guest Vagrant created for us.
Once it’s finally up and you’re logged in, it works much like any of the other install methods (NOTE: again, these commands are run on the guest box).
Text Only | |
---|---|
1 2 3 |
|
More Vagrant HOST Steps¶
Moved here.