Turbocharged Vagrantfiles with Linux, Mac, and Windows Support

The Vagrantfiles in this repository have been optimized for the
AracPac Vagrant boxes. Important configuration details like the box IP,
primary hostname and aliases, and local and remote share points can be configured by modifying variables at the top of
each Vagrantfile. Some features of these Vagrantfiles are:

• ✅ Linux / Mac / Windows host OS support for all functionality
• ✅ Reverse NFS mounts automated by triggers
• ✅ Automatic shell scripts generated to enable and configure NFS support on Windows
• ✅ Various commented performance tweaks

Beginner’s Guide

Software

First, you will first need to download and install vagrant and
virtualbox.

Plugins

Once you’ve installed vagrant, you will also need to install the
Vagrant Host Manager plugin, which you can do from the command
line after vagrant is installed:

vagrant plugin install vagrant-hostmanager

Setting up your local development folder

1. Inside your local user directory, create a dev directory, and within that, a boxes and src directory:

   .
   └── dev
    ├── boxes  <-- used to store vagrant instances
    └── src    <-- used to store git source code

2. Navigate to the src directory using a command shell and clone this codebase by issuing the command below. This will
   download all the source code from this repository to your computer. You will be prompted for your GitHub username and
   password.

   git clone https://github.com/aracpac/aracpac-vagrantfiles

3. You will now have an aracpac-vagrantfiles directory within the src directory. Inside, you will find several OS-specific
   directories, each of which with a corresponding Vagrantfile inside. A Vagrantfile is a small ruby
   script that configures the vagrant software and corresponding virtual machine instance. In this case, the Vagrantfile
   will configure a virtualbox instance, or box.

   .
   └── dev
    ├── boxes
    └── src
        └── aracpac-vagrantfiles
            ├── README.md
            ├── centos9-stream             <-- Vagrant configuration files to use for a CentOS 9 virtual machine
                └── Vagrantfile
            └── ubuntu22                   <-- Vagrant configuration files to use for a Ubuntu 22 virtual machine
                └── Vagrantfile
            ...

4. Now navigate to the boxes folder using your command shell, create a new directory called aracpac, and copy one of
   the Vagrantfiles into this directory. NOTE: you will need to create a new empty directory with a unique
   Vagrantfile for every box you wish to create. Be sure to update the # local ip for the box and # domain for the box configuration variables at the top of each Vagrantfile.

5. Navigate to the aracpac directory using a command shell and issue vagrant up. Vagrant should now download the box
   and set up a local environment for you to use. NOTE FOR WINDOWS USERS: the first time you run vagrant up, the
   script may end with an error if you do not have
   Services for Network File System
   installed. This is expected and addressed in the next step.

6. ONE TIME STEP FOR WINDOWS USERS: After running vagrant up, you will find a new file in the aracpac directory
   called nfs_fix.bat. Run this file from the command shell, and when prompted, enter administrator user credentials,
   then issue vagrant up againt after the script runs. The script will:

   • enable Services for Network File System
   • map the Windows anonymous user’s uid and gid to 1000, which is the uid of the vagrant user in the box
   • set the default windows filemode to 775, which ensures files and directories created on the nfs share are group
     writable

Next steps

Once vagrant is ready, you can:

• ssh into the box by issuing the vagrant ssh command
• access the box through your web browser at https://dev.local/
• access the files in the box’s webroot: on Windows, via the X: drive, and on Linux and Mac, via the ./www folder
  that is created in your project directory