You've already forked documentation
mirror of
https://github.com/armbian/documentation.git
synced 2026-01-06 10:13:36 -08:00
baf698f680
Many less links this time around. However I want to note the various reasons there were still some broken links: In some cases, it was because httpS is not supported on some sites where I might have expected it to be (Sourceforge, etc.) and were (perhaps too optimistically) changed in last (mass) http to httpS update. In other cases, previously updated links needed to be updated to their final redirect location, which could not be seen (easily) until the changes went live. In other cases, there were more than one link to same site with the same problem, and I had only searched for one link on the page (and thus missed the others). And finally, in at least one case (F3) it appears the site already went down in the meantime. All of above cases should now be remedied. However I do plan on running the link checker (at least) one more time again once this latest batch of changes go live, just to make sure.
77 lines
3.6 KiB
Markdown
77 lines
3.6 KiB
Markdown
# Quick Start with Vagrant
|
|
|
|
## Vagrant HOST Steps
|
|
|
|
The following steps are performed on the *host* that runs Vagrant.
|
|
|
|
### Installing Vagrant and Downloading Armbian
|
|
|
|
#### Virtualbox Version
|
|
|
|
**WARNING:** We'll be using [Virtualbox as a virtualization provider for Vagrant](https://www.vagrantup.com/docs/providers/virtualbox). Virtualbox has [documented issues running Xenial under heavy disk IO](https://bugs.launchpad.net/cloud-images/+bug/1616794). Please make sure your version of Virtualbox is >= 5.1.12 where the issue, ["Storage: fixed a problem with the LsiLogic SCSI controller where requests could be lost with SMP guests"](https://www.virtualbox.org/wiki/Changelog), appears to have been resolved.
|
|
|
|
First, you'll need to [install Vagrant](https://www.vagrantup.com/downloads.html) on your host box. Next, 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.
|
|
|
|
vagrant plugin install vagrant-disksize
|
|
|
|
Now we'll need to [install git](https://git-scm.com/downloads) 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.
|
|
|
|
# Clone the project.
|
|
git clone --depth 1 https://github.com/armbian/build
|
|
|
|
# Make the Vagrant box available. This might take a while but only needs to be done once.
|
|
vagrant box add ubuntu/focal64
|
|
|
|
# If the box gets updated by the folks at HashiCorp, we'll want to update our copy too.
|
|
# This only needs done once and a while.
|
|
vagrant box update
|
|
|
|
### Armbian Directory Structure
|
|
|
|
Before we bring up the box, take note of the [directory structure]( https://docs.armbian.com/Developer-Guide_Build-Process/#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](https://docs.armbian.com/Developer-Guide_User-Configurations/).
|
|
|
|
### 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.
|
|
|
|
# We have to be in the same directory as the Vagrant file, which is in the build/config/templates directory.
|
|
|
|
cd build/config/templates
|
|
|
|
# Note that you can edit the Vagrant file to specify the number of cpus and amount of memory you want Vagrant to use.
|
|
|
|
# And now we simply let vagrant create our box and bring it up.
|
|
|
|
vagrant up
|
|
|
|
# When the box has been installed we can get access via ssh.
|
|
# (No need for passwords, Vagrant installs the keys we'll need.)
|
|
vagrant ssh
|
|
|
|
### 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):
|
|
|
|
# Shutdown, but leave the box around for more building at a later time:
|
|
vagrant halt
|
|
|
|
# Trash the box and remove all the related storage devices.
|
|
vagrant destroy
|
|
|
|
## Important note
|
|
|
|
It is strongly recommended to halt and restart the Vagrant box after building an image. Check [this](https://github.com/armbian/build/issues/751) 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).
|
|
|
|
# Let's get building!
|
|
cd armbian
|
|
sudo ./compile.sh
|
|
|
|
## More Vagrant HOST Steps
|
|
|
|
Moved [here](Developer-Guide_Using-Vagrant.md#shut-down-clean-up).
|