vagrant-projects

A collection of Vagrant projects that provision Oracle and other software automatically, using Vagrant, an Oracle Linux box, and shell scripts. Unless indicated otherwise, these projects work with both Oracle VM VirtualBox and libvirt/KVM.

Prerequisites

All projects in this repository require Vagrant and either Oracle VM VirtualBox or libvirt/KVM with the vagrant-libvirt plugin.

If using VirtualBox

1. Install Oracle VM VirtualBox
2. Install Vagrant

If using libvirt/KVM on Oracle Linux

1. Read Philippe's blog post for instructions on using the Vagrant libvirt provider

Getting started

1. Clone this repository git clone https://github.com/oracle/vagrant-projects
2. Change into the desired project folder
3. Follow the README.md instructions inside the folder

Known issues

Metadata not found when creating new VM

We have recently renamed this repository. Unfortunately the new URL for the boxes metadata will not be taken into consideration if you already have a box locally (See Vagrant issue #9637).

You will see the following when you create a new VM:

==> ol7-vagrant: Checking if box 'oraclelinux/7' version '7.8.103' is up to date...
==> ol7-vagrant: There was a problem while downloading the metadata for your box
==> ol7-vagrant: to check for updates. This is not an error, since it is usually due
==> ol7-vagrant: to temporary network problems. This is just a warning. The problem
==> ol7-vagrant: encountered was:
==> ol7-vagrant:
==> ol7-vagrant: The requested URL returned error: 404 Not Found

When this happens:

1. Ensure you have the correct metadata URL in your Vagrantfile:
   BOX_URL = "https://oracle.github.io/vagrant-projects/boxes"
2. Remove your local copy of the box -- E.g. for oraclelinux/7:
   vagrant box remove --all oraclelinux/7

Hyper-V on Windows hosts

The projects in this repository are unlikely to work correctly on Windows hosts with Hyper-V enabled.

Windows features that enable Hyper-V include Application Guard, Containers, Credential Guard, Device Guard, Hyper-V, Virtual Machine Platform, Windows Hypervisor Platform, Windows Sandbox, and Windows Subsystem for Linux (WSL2 only; WSL1 does not use Hyper-V). If you encounter problems with the projects on a Windows host, please try disabling these features.

To completely disable all Hyper-V features, it may be necessary to run the command bcdedit /set hypervisorlaunchtype Off from an Administrator Command Prompt. After running this command, reboot the computer.

Contributing

If your project has specific contribution requirements, update the CONTRIBUTING.md file to ensure those requirements are clearly explained.

This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide.

Security

Please consult the security guide for our responsible security vulnerability disclosure process.

Feedback

Please provide feedback of any kind via Github issues on this repository.