Deploy OpenNebula On-prem with miniONE

In this tutorial, we’ll install an OpenNebula Front-end in under ten minutes, using miniONE, the installation tool provided by OpenNebula.

The miniONE tool is a simple script that allows you to install an OpenNebula Front-end with a single command. It installs quickly and easily and is a great tool for learning and evaluation. After running miniONE, all the OpenNebula services needed to use, manage and run the cloud will be installed on a single Front-end.

This tutorial covers installation of a Front-end and KVM hypervisor node on the local machine. The resulting installation uses a private IP for communication between the Front-end and Virtual Machines, so it is not suitable for deploying resources to remote infrastructure.

With this setup, during installation miniONE will:

  • Install OpenNebula from the software packages
  • Install a KVM hypervisor on the local machine
  • Automatically download a Virtual Machine template for the Alpine Linux 3.20 OS from the OpenNebula Marketplace)

After installation, we will use the Sunstone UI to try out and manage these components.

To install an OpenNebula Front-end using miniONE, we’ll need to complete the following high-level steps:

  1. Ensure that the host server meets the installation requirements.
  2. Download and run the miniONE script.
  3. Verify the installation.

Step 1: Verify Installation Requirements

To run the miniONE script, you will need a physical or virtual server with a fresh installation of a supported operating system, with the latest software updates and without any customizations. The server will need an internet connection to download software packages during installation.

Supported operating systems:
  • RHEL/AlmaLinux 8 or 9
  • Debian 11 or 12
  • Ubuntu 22.04 or 24.04
Minimum hardware:
Configuration:
  • Access to the privileged user (root) account
  • An SSH server running on port 22
  • Open ports:
    • 22 (SSH)
    • 80 (for the web UI)

This tutorial was tested on on Ubuntu 22.04 and 24.04.

Step 2: Download and Install miniONE

You can download miniONE from the GitHub repository.

To quickly download miniONE, run:

wget 'https://github.com/OpenNebula/minione/releases/latest/download/minione'

After downloading, open a terminal and use the sudo to become the root user. For example, run:

sudo -i

Go to the folder where you downloaded the miniONE script, by using the cd command:

cd <path/to/folder>

Next, ensure that the minione file has execute permissions:

chmod +x minione

To install miniONE, run as root:

./minione

The miniONE script will begin the installation, logging output to the terminal. Installation usually takes between one and two minutes. When it’s finished, miniONE shows a report with connection parameters and login credentials:

### Report
OpenNebula 6.99 was installed
Sunstone is running on:
  http://192.168.1.130/
Use following to login:
  user: oneadmin
  password: ZMCoOWUsBg

Finally we will force a refresh of the localhost status:

sudo -u oneadmin onehost sync --force

At this point, you have successfully installed miniONE. OpenNebula services should be running, and the system should be ready for your first login.

Step 3: Verify the Installation

We will verify the installation by logging in to OpenNebula’s Edge Sunstone GUI.

Point your browser to the Edge IP and port provided by the miniONE report, in this case 192.168.1.130:80, or simply to http://localhost. You should be greeted with the Sunstone login screen:

image

In the Username input field, type oneadmin. For Password, enter the password provided by miniONE at the end of the report (in this example, ZMCoOWUsBg) then press Enter or click SIGN IN.

The screen should display the Sunstone Dashboard:

image

As you can see, the Dashboard indicates the following installed components:

  • 1 VM template
  • 1 image
  • 1 virtual network

The installed virtual network is a bridged network attached to a local interface. To see this network, in Sunstone open the left-hand menu (by hovering the mouse over the left-hand pane), then click Networks –> Virtual Networks:

image

Sunstone should display the Virtual networks screen. Clicking the network name displays info tabs for the network:

image

During installation, a KVM virtualization host was automatically configured on the local server. To see the KVM host, in Sunstone open the left-hand menu, then click Infrastructure -> Hosts.

Deploying a Virtual Machine Locally

During installation, miniONE automatically downloaded the template for a Virtual Machine with Alpine Linux 3.20 preinstalled. Using the Sunstone UI, we can now instantiate this Virtual Machine on the local KVM host with a few clicks.

To deploy the Alpine Linux VM, go to Templates -> VM Templates. This screen displays a list of all VM templates installed on the system. In this case, only the Alpine Linux 3.20 template is installed:

image

To instantiate the VM template, click the template name, then click the Instantiate icon image at the top.

Sunstone will display the first screen of the Instantiate VM Template wizard:

image

Feel free to modify the Capacity parameters if desired, or leave at their default values.

Click Next.

The next screen allows you to see and modify further parameters for the VM, including selecting the virtual network or scheduling actions.

image

Click Finish.

OpenNebula will instantiate the VM template. For the Alpine Linux VM, this should take just a few seconds. Once instantiation is complete, Sunstone should display the Instances -> VMs screen, with the Alpine Linux VM as the sole instance:

image

The green dot to the left of the VM name indicates that the VM is running. Note that you may need to click the Refresh icon image at top left for the VM to display the running state.

Logging into the Virtual Machine

The quickest way to log into the VM is by VNC, available directly in Sunstone. Just click the VNC icon image and Sunstone should display the VM boot messages screen directly in your browser.

image

Log in as root with password opennebula.

Congratulations! You’ve installed an OpenNebula Front-end with a KVM hypervisor and virtual network, then deployed a Virtual Machine.

To explore the resources in the environment you’ve just created, see Validate the miniONE Environment — where additionally you can learn how to quickly download virtual appliances from the OpenNebula Marketplace and deploy them to your new cloud.