Skip to main content

Installation

Guided Installation​

Please review the system requirements prior to attempting any installation.

For production installations, most scenarios can rely on the guided quickstart.sh installer. This installer allows the user to bring their own flavor of Kubernetes, and will validate prerequisites and prompt for required inputs. Optionally, the installer will also setup K3s as a single-node cluster if there is not a cluster available.

Requirements for the installer:

  • Must be run from an Ubuntu 22.x or Ubuntu 24.x machine
  • A user with sudo permissions
  • The install script will verify certain package prerequisites, and ask to install them if they are not available
  • For an existing Kubernetes installation, Kubernetes context must already be loaded into the shell session. This installer will verify access by running: kubectl cluster-info

The quickstart installer will step through the following processes:

  • Verify binary prerequisites exist on the current machine
  • Verify connectivity and kubectl access to a running Kubernetes cluster
  • Verify that a default storage class exists on the current cluster
  • Optionally install the Netfoundry Support stack to the "support" namespace
  • Optionally install the OpenZiti ziti-controller helm chart to the "ziti" namespace
  • Optionally install a Ziti edge router with edge listener enabled to the "ziti" namespace (requires an advertise address that is reachable by the Ziti network clients)
  • Optionally install Ziti network resources for support tool access (Ziti services and policies for Grafana, Kibana, and RabbitMQ)
  • Optionally install Ziti edge tunnel as a host identity to access the above support resources in the "support" namespace

Installing behind a corporate proxy?​

Installing from behind a proxy requires some additional setup steps. Review the proxy setup documentation before running the quickstart.sh