c8k.in: One-liner installer for Apache CloudStack
Note
Supports Apache CloudStack (version >= 4.20) installation on Ubuntu or EL based distro with x86_64 KVM. Please use this on a throwaway host or a VM (with hardware acceleration) that wouldn't hurt you to lose, in an RFC1918 local private network. This is currently in beta and open for users testing and issue reporting.
One-liners installer automates and simplifies the installation and configuration of Apache CloudStack and its components:
- CloudStack Management Server
- CloudStack Agent for KVM Host
- CloudStack Usage Server
- MySQL Server
- NFS Server
- All-in-One Installation: Deploy a complete CloudStack setup on a single machine
- Custom Installation: Select specific CloudStack components to install
- Repository Configuration: Set up CloudStack repository automatically
- Zone Deployment: Guided wizard for zone deployment
- Network Configuration: Automatically configure network bridges for CloudStack
- Component Validation: Verify that all components are properly configured
- Progress Tracking: Track installation progress and resume interrupted installations
- Support re-runs, idempotent with tracker
| Resource | Minimum |
|---|---|
| RAM | 8 GB |
| Disk | 75 GB |
| Privileges | Root / sudo |
| Virtualization | Hardware virtualization (Intel VT-x / AMD-V) |
| OS | Version | Status |
|---|---|---|
| Oracle | 9 | ✔️ Validated |
| Oracle | 8 | ✔️ Validated |
| Ubuntu | 24.04 | ✔️ Validated |
| Ubuntu | 22.04 | ✔️ Validated |
| Ubuntu | 20.04 | ✔️ Validated |
| Rocky | 9 | ✔️ Validated |
| Rocky | 8 | ✔️ Validated |
| Alma | 9 | ✔️ Validated |
| Alma | 8 | ✔️ Validated |
Oracle Linux 10, AlmaLinux 10, and Rocky Linux 10 are supported only with CloudStack 4.22.0.0 or later.
sudo dnf install -y epel-release
sudo dnf install -y genisoimagesudo dnf install -y oracle-epel-release-el10
sudo dnf install -y genisoimageTo install and deploy CloudStack, just copy and run the following as root user:
curl -sSfL https://c8k.in/stall.sh | bashcurl -o install.sh https://c8k.in/stall.sh
chmod +x install.sh
sudo ./install.shWhen you launch the installer, you’ll see a dialog menu like this:
Select an option:
1. All-in-One Installation
2. Custom Installation
3. Configure CloudStack Repository
4. Deploy CloudStack Zone
Here’s what each option does:
Performs a full automated setup of Apache CloudStack on a single host.
Includes installation and configuration of:
- CloudStack Management Server
- KVM Agent (libvirt, bridge, VNC, firewall)
- MySQL database server
- NFS primary and secondary storage
- Usage Server
- Zone Deployment
Ideal for test environments, PoC labs, or quick demos — ready to use in under an hour.
Lets you select individual components to install and configure.
Useful when you want to:
- Separate Management and KVM roles across multiple machines
- Install/Configure or skip specific services (e.g., NFS, CloudStack Agent, Skipping Usage Server)
- Integrate with an existing CloudStack deployment
Sets up the official or custom CloudStack package repository for your OS.
Automatically detects your distribution (Ubuntu, Debian, RHEL, Rocky, etc.) and configures:
- GPG key
- Repository URL
- Package source file
You can reconfigure repository using this option at any time to switch versions or mirrors.
After installing the components, this option launches a guided Zone Deployment Wizard that:
- Creates a new CloudStack Zone (Advanced networking)
- Adds Pod, Cluster, Host, and Storage resources
- Configures networking (bridge, IP ranges, VLANs)
Perfect for creating a ready-to-use cloud zone in minutes.
This installer is designed to make Apache CloudStack accessible for learning, testing, and experimentation - without needing a large-scale infrastructure.
- Spin up a fully functional CloudStack zone (management, KVM host, and NFS storage) on a single VM or physical host for development or QA.
- Ideal for CloudStack contributors to test new PRs, validate feature behaviour across OS.
- Experiment with configuration, template registration, Network and zone orchestration.
- Perfect for demo, workshops and PoCs.
| File | Purpose |
|---|---|
installer.log |
Detailed logs for all operations |
cloudstack-installer-tracker.conf |
Tracks completed steps to allow safe re-runs |
After successful setup, CloudStack is accessible at:
URL: http://<management-server-ip>:8080/client
Username: admin
Password: password
-
Avoid pre-installing Java before running this script. Exisiting java installation can cause version conflicts and may break the installer.
-
Use a proper base image when preparing the VM. The ISO should be at least a Minimal Installation to ensure all required packages are available.
-
Installer can't continue if any other process has lock of package manager, you may see such error:
Could not get lock /var/lib/dpkg/lock-frontend. It is held by process 5774 (unattended-upgr) -
Zone Deployment form provides default parameters optimized for an all-in-one CloudStack installation. Review and adjust these values as needed for your deployment.
dialogfor interactive menusaptordnffor package managementsystemctlfor service managementnmapfor IP discovery
Licensed under the Apache License, Version 2.0
See LICENSE for details.
Important
This is only useful for anyone who just wants to try CloudStack on a host or a VM, but does not want to read the official docs. It makes several assumptions about the IaaS deployment, and tries to figure out host's network setup so the deployment could work out of the box. This is not advised for production deployment.
Screenshot when the command finishes:
Get Source or Report an issue: https://github.com/apache/cloudstack-installer