Ansible Vagrant profile for AWX
Vagrant and VirtualBox (or some other VM provider) can be used to quickly build or rebuild virtual servers.
This README file is inside a folder that contains a
Vagrantfile (hereafter this folder shall be called the [vagrant_root]), which tells Vagrant how to set up your virtual machine in VirtualBox.
To use the vagrant file, you will need to have done the following:
- Download and Install VirtualBox
- Download and Install Vagrant
- Install Ansible (guide for installing Ansible)
- Open a shell prompt (Terminal app on a Mac) and cd into the folder containing the
- Run the following command to install the necessary Ansible roles for this profile:
$ ansible-galaxy install -r requirements.yml
Once all of that is done, you can simply type in
vagrant up, and Vagrant will create both new VMs and configure them.
Once the VM is up and running (after
vagrant up is complete and you're back at the command prompt), you can log into it via SSH if you'd like by typing in
vagrant ssh. Otherwise, the next steps are below.
Note: This VM uses 4 GB of RAM by default, because AWX requires a lot of memory to perform well. If you are using a server or local workstation with less than 8 GB of RAM, you might want to manually change the memory requirements to a lower value (the
v.memoryparameter in the
Setting up your hosts file
You need to modify your host machine's hosts file (Mac/Linux:
%systemroot%\system32\drivers\etc\hosts), adding the lines below:
awx.local is the hostname you have configured in the
After that is configured, you could visit http://awx.local/ in a browser, and you'll see the AWX login page. Log in with the default credentials:
Note: The first time you install AWX, it takes some time to set up AWX's database (and this process will peg one CPU core for a while!). If you get a 500 error notice when you visit awx.local, wait a little bit and try again.
If you'd like additional assistance editing your hosts file, please read How do I modify my hosts file? from Rackspace.