Introduction
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
Prerequisites
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:
- 2 vCPUs
- 2048 MB RAM
- Minimal package set installed
- 32 GiB root volume
- 4 GiB swap
- XFS (default) or Btrfs root filesystem
- Guest additions installed
- Yum configured for Oracle Linux yum server. _latest and _addons repos enabled as well as _optional_latest, _developer, _developer_EPEL where available.
Oracle Linux boxes for the VirtualBox Vagrant Provider (x86_64)
| Box | Kernel | Size (MB) | Date added | SHA256 Checksum / Box metadata URL |
|---|---|---|---|---|
| Oracle Linux 9 v9.5.661 | 5.15.0-306.177.4.el9uek.x86_64 | 602 | 15-Mar-2025 | 3681b1e9bfd5e863f2a68280867da5097af3fc89075f4d339a1d919e078c1117 |
| Oracle Linux 9 (Btrfs) v9.5.662 | 5.15.0-306.177.4.el9uek.x86_64 | 485 | 15-Mar-2025 | 5c9552dc561d34c2cb05a41d12c3253a06f7fa3cbe3dabb1fb951085f4825c04 |
| Oracle Linux 8 v8.10.657 | 5.15.0-306.177.4.el8uek.x86_64 | 746 | 15-Mar-2025 | 538bc0dd141f6313e7a514fbc14cf63227db5ce5bb21e65fffb7a5c4ea70444f |
| Oracle Linux 8 (Btrfs) v8.10.658 | 5.15.0-306.177.4.el8uek.x86_64 | 669 | 15-Mar-2025 | 1aace668baecd2b266fbf2d64cd4c3dc3f10a54ffcabef5fbf06a5f8d0b28cc4 |
| Oracle Linux 7 v7.9.653 | 5.4.17-2136.338.4.2.el7uek.x86_64 | 919 | 15-Mar-2025 | 1ec48479084660e3a2a1cd461c86db5d51f1315114bb3d1ae8fb70e0329e3af2 |
| Oracle Linux 7 (Btrfs) v7.9.654 | 5.4.17-2136.338.4.2.el7uek.x86_64 | 1121 | 15-Mar-2025 | 5c49f5552bcef7ad763b894ab3b948a8217c17634e221ebe46a8a5f082f5d73d |
Oracle Linux boxes for the VirtualBox Vagrant Provider (Apple Silicon)
| Box | Kernel | Size (MB) | Date added | SHA256 Checksum / Box metadata URL |
|---|---|---|---|---|
| Oracle Linux 9 aarch64 v9.5.129 | 5.15.0-306.177.4.el9uek.aarch64 | 491 | 17-Mar-2025 | afcce734f624eeca31c72efd1f5d67f0937f1cb774288a97636b42420ac65422 |
| Oracle Linux 8 aarch64 v8.10.125 | 5.15.0-306.177.4.el8uek.aarch64 | 639 | 16-Mar-2025 | 4dee0c6446ce9fe2093f0eb696696b945bf5044ee8dd61e53df3864fb20607cd |
Oracle Linux boxes for the libvirt Vagrant Provider (x86_64)
| Box | Kernel | Size (MB) | Date added | SHA256 Checksum / Box metadata URL |
|---|---|---|---|---|
| Oracle Linux 9 v9.5.663 | 5.15.0-306.177.4.el9uek.x86_64 | 517 | 15-Mar-2025 | 771b6665045f2454482b00a5b66f76849145e658f577eb0e714e945e827337db |
| Oracle Linux 9 (Btrfs) v9.5.664 | 5.15.0-306.177.4.el9uek.x86_64 | 404 | 15-Mar-2025 | 60227a354ed5bc2c2aca874cb24f4888821b9912357f978066ea80c4b1b35400 |
| Oracle Linux 8 v8.10.659 | 5.15.0-306.177.4.el8uek.x86_64 | 497 | 15-Mar-2025 | 3acaeb75b7e4a6ba8efa1c8c6068fe2168ad6f76b3526a12050e29069aab36aa |
| Oracle Linux 8 (Btrfs) v8.10.660 | 5.15.0-306.177.4.el8uek.x86_64 | 426 | 15-Mar-2025 | 2e99da52e4e03b7f3f0ebdaae882212ba2ac1fff6910b5a3db018c456828ea3e |
| Oracle Linux 7 v7.9.655 | 5.4.17-2136.338.4.2.el7uek.x86_64 | 914 | 15-Mar-2025 | cac58aef332f554a0e6c4060afd3db81923ee91be7a4eaf45544d805c8252678 |
| Oracle Linux 7 (Btrfs) v7.9.656 | 5.4.17-2136.338.4.2.el7uek.x86_64 | 1069 | 15-Mar-2025 | 26ad60a66b0859f2abe0417b8ca3cc496d070287c605ef996b7d1e9506ceff3a |
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:
- Oracle Linux 9: https://oracle.github.io/vagrant-projects/boxes/oraclelinux/9.json
- Oracle Linux 9 with Btrfs root filesystem: https://oracle.github.io/vagrant-projects/boxes/oraclelinux/9-btrfs.json
- Oracle Linux 8: https://oracle.github.io/vagrant-projects/boxes/oraclelinux/8.json
- Oracle Linux 8 with Btrfs root filesystem: https://oracle.github.io/vagrant-projects/boxes/oraclelinux/8-btrfs.json
- Oracle Linux 7: https://oracle.github.io/vagrant-projects/boxes/oraclelinux/7.json
- Oracle Linux 7 with Btrfs root filesystem: https://oracle.github.io/vagrant-projects/boxes/oraclelinux/7-btrfs.json
$ vagrant init oraclelinux/{release} <box json url>
$ vagrant up
$ vagrant ssh
For example:
$ vagrant init oraclelinux/8 https://oracle.github.io/vagrant-projects/boxes/oraclelinux/8.json
$ vagrant up
$ vagrant ssh
To launch an Oracle Linux 8 box with Btfs root filesystem :
$ vagrant init oraclelinux/8-btrfs https://oracle.github.io/vagrant-projects/boxes/oraclelinux/8-btrfs.json
$ 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 github.com/oracle
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.
