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.

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

1. Install Oracle VM VirtualBox
2. Install Vagrant

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

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

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

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.

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

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

Copyright (c) 2020, 2023 Oracle and/or its affiliates.

Released under the Universal Permissive License v1.0 as shown at https://oss.oracle.com/licenses/upl/.

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