Deploy an OpenNebula Front-end On-premises

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

This simple installation includes a single OpenNebula Front-end without any hypervisor nodes. You can perform the installation on any physical or virtual server that meets the system requirements. Later, you can use this Front-end to provision resources on cloud providers, for example as described in Provisioning an Edge Cluster.

miniONE is a simple Bash script. It automatically downloads, installs and configures an OpenNebula Front-end and all necessary components to manage and run virtual machines.

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.

The cloud environment installed by miniONE is mainly intended for evaluation, development and testing. However, it can also serve as a base for larger short-lived deployments.

Important

In this tutorial, we will install a Front-end only, without a KVM hypervisor. While the miniONE script offers the option to install both a Front-end and a KVM hypervisor on the same server, that configuration does not allow you to provision remote resources, and is not covered in this tutorial.

Step 1: Ensure System 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.

Supported operating systems:
  • RHEL/AlmaLinux 8 or 9

  • Debian 11 or 12

  • Ubuntu 22.04 or 24.04

Minimum hardware:
  • 4 GiB RAM

  • 80 GiB free disk space

Configuration:
  • Access to the privileged user (root) account

  • A public IP address

  • An SSH server running on port 22

  • Open ports:
    • 22 (SSH)

    • 80 (for the Ruby Sunstone GUI)

    • 2616 (for the FireEdge GUI)

    • 5030 (for the OneGate service)

Note that the server needs an internet connection to download software packages during installation.

Step 2: Download and Install miniONE

To download miniONE, please fill the required form.

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, by running:

chmod +x minione

To install miniONE, run:

bash minione --frontend

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.8 was installed
Sunstone is running on:
http://<omitted>/
FireEdge is running on:
http://<omitted>:2616/
Use following to login:
   user: oneadmin
   password: lCmPUb5Gwk

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

Important

In this configuration, the Ruby and FireEdge Sunstone endpoints, and the OneGate endpoint expose HTTP on a public network interface. miniONE is an evaluation tool, and this configuration should not be used in production environments.

Step 3: Verify the Installation

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

Point your browser to the FireEdge IP and port provided by the miniONE output shown above, i.e. http://<public IP>:2616. (Alternatively, if you installed locally you can go to http://localhost:2616.) You should be greeted with the Sunstone login screen:

../../_images/sunstone-login.png

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

The screen should display the Sunstone Dashboard:

../../_images/sunstone-dashboard.png

This is the default view for cloud administrators. From this view in Sunstone, you have complete control over your OpenNebula infrastructure. (The Cloud View interface is much simpler, intended for end users.) To explore what you can do in the GUI, open the left-hand panel by clicking on the hamburger icon on the top left:

../../_images/sunstone-dashboard_hamb_menu.png

Congratulations — you have deployed an OpenNebula Front-end node, which is ready to provision resources on cloud infrastructure.

Additional Installation Options

The miniONE script offers several options for installation, which you can check by passing the -h flag, e.g.:

bash minione -h

Options include setting parameters for the virtual network, passwords for new VMs, and others.

Tip

If you run miniONE without any options, it will install an OpenNebula Front-end and a KVM hypervisor node on the local machine. With this configuration you will be able to deploy VMs to the local machine, but you will not be able to provision remote resources, since this type of installation uses a private IP address for communicating with VMs.

Next Steps

The Operations Guide allows you to quickly and easily provision your cloud, by adding a remote Edge Cluster on AWS.