Skip to content

ISO Installation

To get the Harvester ISO, download it from the Github releases.

During the installation you can either choose to form a new cluster, or join the node to an existing cluster.

Note: This video shows a quick overview of the ISO installation.

  1. Mount the Harvester ISO disk and boot the server by selecting the Harvester Installer. iso-install.png
  2. Choose the installation mode by either creating a new Harvester cluster, or by joining an existing one.
  3. Choose the installation device that the Harvester will be formatted to.
  4. Configure the hostname and select the network interface for the management network, by default harvester will create a bond NIC named harvester-mgmt, and the IP address can either be configured via DHCP or static method. iso-installed.png
  5. (Optional) Configure the DNS servers, use commas as a delimiter.
  6. Config the Virtual IP which you can use for accessing the cluster or joining the cluster by the other nodes.
  7. Configure the cluster token. This token will be used for adding other nodes to the cluster.
  8. Configure the login password of the host. The default ssh user is rancher.
  9. (Optional) Config the NTP Servers of the node if needed, default to 0.suse.pool.ntp.org.
  10. (Optional) If you need to use an HTTP proxy to access the outside world, enter the proxy URL address here, otherwise, leave this blank.
  11. (Optional) You can choose to import SSH keys from a remote URL server. Your GitHub public keys can be used with https://github.com/<username>.keys.
  12. (Optional) If you need to customize the host with cloud-init config, enter the HTTP URL here.
  13. Confirm the installation options and the Harvester will be installed to your host. The installation may take a few minutes to be complete.
  14. Once the installation is complete it will restart the host and a console UI with management URL and status will be displayed. (You can Use F12 to switch between Harvester console and the Shell)
  15. The default URL of the web interface is https://your-virtual-ip. iso-installed.png
  16. User will be prompted to set the password for the default admin user on the first-time login. first-login.png