This feature is a Technology Preview. It’s not recommended for production environments!

As a complement to the traditional installation via operating system packages (see Single Front-end Installation), it’s possible to deploy the complete OpenNebula Front-end (except hypervisor nodes!) in the container(s). The official OpenNebula Front-end container image can be used with Docker and Podman container runtimes and multiple deployment scenarios.

Containerized Front-end deployment features:

  • Simpler and faster setup than conventional installation.
  • Easy code rollback to the previous version on upgrade failure (NOTE: still requires reverting to a particular snapshot of database/datastores).
  • Reproducible setup with all dependencies and their versions persisted (and fully certified) in the image.
  • Use on new platforms for which there are no OpenNebula packages yet.
  • Improved security with Front-end isolation among services and from the Host.
  • Multi-tenant deployment when a single Host can run multiple isolated instances of OpenNebula Front-end.
  • Requires proficiency in using and maintaining container runtime environments!
  • Might look harder or less transparent when compared to the traditional approach!
  • Supports only direct deployment on Docker and Podman runtimes (not Kubernetes or others).
  • Deploys only Front-end, hypervisor Nodes must be handled separately in a traditional way. See Open Cluster Deployment.


Check the comprehensive explanation and comparison of virtual machines and containers on What is a Container? page at Docker website. You can then follow this with more in-depth documentation and tutorial. Please note the administrator is required to have knowledge about using and maintaining the containerized deployments. These topics are not covered by these guides!

How Should I Read This Chapter

Start with the Architecture and Simple Deployment where you learn how to deploy the simple containerized OpenNebula Front-end. Continue with the Advanced Deployment Customizations for a more fine-tuned deployment and description of the internal Bootstrap Process. The last section Troubleshooting and Reference is a helpful guide for various deployment configurations. It starts with a few troubleshooting hints and tutorials, and follows up with a complete reference about all deployment parameters and options.

Hypervisor Compatibility

This chapter applies to all supported hypervisors.