Skip to content

Ubuntu Setup Script

OVA is preferred

We highly recommend using our OVA virtual machine for NodeZero installation, as it is the preferred method to ensure a seamless setup.

Set Up Ubuntu for Running NodeZero®

If deploying the OVA is not a viable option for your infrastructure, Horizon3.ai provides a script to help set up a base Ubuntu 20.04 or 24.04 LTS OS for use with NodeZero.

Minimum Specifications

The NodeZero host requires a minimum configuration of:

  • 2 x CPUs (4 x recommended)
  • 8GB of RAM
  • 40GB of disk (128GB recommended)
  • Bridged network adapter

Before Setting Up

If your environment restricts access to external sites through an outbound proxy or similar mechanism, please make sure that it allows connections to the following sites:

  • *.ubuntu.com
  • *.canonical.com
  • downloads.horizon3ai.com
  • download.docker.com

Downloads

Tip

Always verify that the files you're downloading come from Horizon3.

NodeZero Ubuntu Setup Script

Download SHA256

Running the Script

User Permissions

A user with sudo permission is required. Do not install as root.

Download the script onto the host that is going to be running NodeZero, execute and run the script. After running the script it can be removed.

curl -o linux-build.sh https://downloads.horizon3ai.com/utilities/linux-build.sh
bash linux-build.sh
sudo rm -f linux-build.sh

System Updates and Reboots

Executing this script "as is" will update the OS libraries that do not require user interaction. The script will automatically reboot the OS upon completion.

What the Script Does

This script sets up ubuntu with the required libraries for NodeZero to run successfully on the host machine. It sets the MOTD letting users that login know they are logging into a NodeZero host and it installs 2 utilities (h3-cli and n0)

h3-cli allows for communication and management of NodeZero on the host.

Host Utility enables management of the NodeZero hosts settings.

This script does the following:

  • Disables journald
  • Disables the firewall (ufw)
  • Updates the OS
  • Installs the following libraries:
    • cloud-init
    • open-vm-tools
    • docker.io
    • nmap
    • tcpdump
    • dnsutils
    • unzip
    • jq
    • telnet
  • Sets up Message of the Day (MOTD)
  • Downloads h3-cli
  • Downloads Host Utility
  • Adds current user to docker group

A successful run of the script looks like this:

A terminal screen showing the command linux-build.sh. It ends with Enabling docker... and Building NodeZero-CUSTOM

Validate Host
Test connectivity and Docker to confirm readiness.