Vagrant is a tool to manage virtual machine-based development environments. Vagrant Boxes are pre-built base images that can be imported into Vagrant as a starting point. Read more about Vagrant here. On this page Oracle publishes Vagrant boxes based on Oracle Linux.

Using Oracle Linux Vagrant boxes


You will need the following software installed on your machine. Check the minimum required versions in the Vagrant Box description.

Latest Available Boxes

These boxes are configured as follows:

Oracle Linux boxes for the VirtualBox Vagrant Provider

Box Kernel Size (MB) Date added SHA256 Checksum

Oracle Linux boxes for the libvirt Vagrant Provider

Box Kernel Size (MB) Date added SHA256 Checksum

Adding, downloading and starting the Oracle Linux Vagrant Box

Create a working directory for your development project and from within that directory, issue the following commands, subsituting the url for one of the following, depending on the release of Oracle Linux you want:

$ vagrant init oraclelinux/{release} <box json url>
$ vagrant up
$ vagrant ssh

For example:

$ vagrant init oraclelinux/8
$ vagrant up
$ vagrant ssh

To launch an Oracle Linux 8 box with Btfs root filesystem :

$ vagrant init oraclelinux/8-btrfs
$ vagrant up
$ vagrant ssh

Updating an Oracle Linux box

To check whether an of your installed boxes have available updates:

$ vagrant box outdated --global

To update an Vagrant box to the latest available version:

$ vagrant box update --box oraclelinux/9

Sample Vagrant projects with Oracle products on GitHub

Example Vagrant projects that provision Oracle products including Oracle Database, Oracle Dataguard, Oracle Real Application Clusters, Oracle Container Services for Kubernetes, and more are available on

Where can I get help with these Vagrant boxes?

These Vagrant Boxes are provided as is, free of charge and without support from Oracle. Peer support is available in the Oracle Linux space on the Oracle Developer Community.

Contact Us