Skip to main content
Building a private cloud on bare metal gives you both flexibility and control. It provides cloud-like agility with the dedicated performance of physical servers. This keeps you in charge of your infrastructure, avoiding the limitations of public cloud providers. In this guide, we’ll walk you through setting up your own private cloud on the Latitude.sh platform using Harvester, an open-source hyper-converged infrastructure (HCI) solution. Harvester simplifies managing virtual machines and Kubernetes clusters on your servers, giving you a unified system that supports cloud-native workloads from the core to the edge. So let’s jump right in!

​
Requirements

  • 1 Latitude.sh server (3 recommended for high availability, but not required)
  • Harvester iPXE script for cluster setup
  • IP address range to assign to your VMs (at least 1 /29 block for both cluster and VM, or 2 /29 blocks to separate traffic between them)

​
Step 1: Prepare the iPXE script

1

Get the iPXE script

Go to the Latitude.sh repository, or copy the script below to automatically install Harvester on your server:
#!ipxe

ifopen net{{ INTERFACE_ID }}
set net{{ INTERFACE_ID }}/ip {{ PUBLIC_IP }}
set net{{ INTERFACE_ID }}/netmask {{ NETMASK }}
set net{{ INTERFACE_ID }}/gateway {{ PUBLIC_GW }}
set net{{ INTERFACE_ID }}/dns 8.8.8.8

kernel https://releases.rancher.com/harvester/master/harvester-master-vmlinuz-amd64 ip={{ PUBLIC_IP }}::{{ PUBLIC_GW }}:{{ NETMASK }}::enp1s0f{{ INTERFACE_ID }}:off:8.8.8.8 rd.cos.disable rd.noverifyssl net.ifnames=1 root=live:https://releases.rancher.com/harvester/master/harvester-master-rootfs-amd64.squashfs console=ttyS1,115200n8 harvester.install.automatic=true harvester.install.skipchecks=true harvester.install.config_url={{HARVESTER-CONFIG-FILE}}
initrd https://releases.rancher.com/harvester/master/harvester-master-initrd-amd64`

boot
In the boot.ipxe script, you must replace HARVESTER-CONFIG-FILE with the URL of your customized Harvester configuration file.
2

Configure the Harvester config file

For the first node, configure the HARVESTER-CONFIG-FILE.yaml shown below, replacing the placeholders with your environment details.
scheme_version: 1
token: {{CLUSTER-TOKEN}}
os:
hostname: {{HOSTNAME}} # Set a hostname. This can be omitted if DHCP server offers hostnames.
ssh_authorized_keys:

- {{SSH_PUBLIC_KEY}}
  password: {{ENCRYPTED_PASSWORD}}
  ntp_servers:
- 0.suse.pool.ntp.org
- 1.suse.pool.ntp.org
  dns_nameservers:
  - 8.8.8.8
  - 1.1.1.1
  install:
  mode: create
  management_interface:
  interfaces:
  - name: {{INTERFACE_NAME}}
  default_route: true
  method: static
  bond_options:
  miimon: 100
  ip: {{PUBLIC_IP}}
  subnet_mask: {{PUBLIC_SUBNET}}
  gateway: {{PUBLIC_GW}}
  device: {{BLOCK-STORAGE-DEVICE}}
  iso_url: https://releases.rancher.com/harvester/master/harvester-master-amd64.iso
  tty: ttyS1,115200n8 # For machines without a VGA console

vip: {{VIRTUAL-IP-FOR-CLUSTER-MANAGEMENT}}
vip_mode: static # Or static
vip_hw_addr: # Leave empty when vip_mode is static
To replace the placeholders in the HARVESTER-CONFIG-FILE.yaml, follow these steps:
  1. CLUSTER-TOKEN: This is a unique token used to create the cluster and join new nodes. You can generate a random string (e.g., openssl rand -hex 16) or create a meaningful token.
  2. HOSTNAME: Replace this with the hostname of your server. This can be anything meaningful to you, like node1, harvester-master, etc.
  3. SSH_PUBLIC_KEY: Enter your public SSH key here. This allows you to log in to the server via SSH after installation. You can find your public key by running cat ~/.ssh/id_rsa.pub on your local machine.
  4. ENCRYPTED_PASSWORD: Replace this with an encrypted password (hashed with bcrypt, for example). You can generate this using a password generator or encryption tool like openssl.
  5. INTERFACE_NAME: Set this to your network interface name (e.g., eth0, enp1s0, etc.). You can find this by running ip a or ifconfig on your server to identify the network interface name.
  6. PUBLIC_IP: This should be the static public IP address assigned to the server. It’s the IP you want to use for the management interface.
  7. PUBLIC_SUBNET: Replace this with the subnet mask of the network your server is in.
  8. PUBLIC_GW: This is the gateway IP address for your network, typically the IP address of your router.
  9. BLOCK-STORAGE-DEVICE: Specify the storage device where Harvester should be installed. This is typically something like /dev/sda or /dev/nvme0n1, depending on your server’s disk layout.
  10. VIRTUAL-IP-FOR-CLUSTER-MANAGEMENT: This is the virtual IP (VIP) that will be used for cluster management. It must be an unused IP in the same subnet as your public IP and dedicated for cluster management.

​
Step 2: Request additional IPs

Depending on the number of VMs and services you plan to deploy, calculate the required IP addresses. If you’re running out of available IPs, you may need to request additional IPs.
1

Submit IP request

Go to Networking > IP Addresses on the Latitude.sh dashboard to request additional IPs:
  • Select the required number of IPs. Request at least 1 /29 block for both cluster and VM, or 2 /29 blocks to separate traffic between them.
  • Provide a justification for the request (e.g., setting up a Harvester-based private cloud)
2

Assign IPs to Virtual Machines

Once you’ve received additional IP addresses, assign them to your VMs in Harvester.

​
Step 3: Boot the server

In the Latitude.sh dashboard, click Reinstall from the server Actions menu, choose Custom image (iPXE) as the OS, and paste your modified boot.ipxe script with the URL of your customized Harvester configuration file. This will automatically install Harvester on the server and configure it as the management node for your cluster. Harvester iPXE installation For additional nodes, boot each node using the corresponding iPXE script and the HARVESTER-ADD-NODE-TO-CLUSTER.yaml configuration to join the existing cluster.

​
All set!

With your Harvester cluster deployed, you now have full control over your cloud-native workloads and the flexibility to scale as your needs evolve. This setup ensures high-performance virtualization while maintaining the manageability of cloud environments.
⌘I