How to Install Wallaroo Enterprise on Cloud Platforms

Organizations that use cloud services such as Google Cloud Platform (GCP), Amazon Web Services (AWS), or Microsoft Azure can install Wallaroo Enterprise.

Installation Flow

A typical installation of Wallaroo Enterprise follows this flow:

  • Create Environment: Create the environment to install Wallaroo that meets the system prerequisites.
  • Install Wallaroo: Install Wallaroo into the target environment.
  • Configure DNS: Configure DNS services and the Wallaroo instance for your organization’s use.

Before installation, the following prerequisites must be met:

  • Have a Wallaroo Enterprise license file. For more information, you can request a demonstration.
  • Set up a cloud Kubernetes environment that meets the requirements. Clusters must meet the following minimum specifications:
    • Minimum number of nodes: 4
    • Minimum Number of CPU Cores: 8
    • Minimum RAM: 16 GB
    • A total of 625 GB of storage will be allocated for the entire cluster based on 5 users with up to four pipelines with five steps per pipeline, with 50 GB allocated per node, including 50 GB specifically for the Jupyter Hub service. Enterprise users who deploy additional pipelines will require an additional 50 GB of storage per lab node deployed.
    • Kubernetes requirements:
      • Kubernetes Version
      • 1.20 is the minimum requirement
      • 1.22 is preferred
      • 1.23 is not yet supported
    • Runtime: containerd is required.
  • DNS services for integrating your Wallaroo Enterprise instance. See the DNS Integration Guide for the instructions on configuring Wallaroo Enterprise with your DNS services.

For details on setting up your Kubernetes cloud cluster, see the How to Set Up Your Wallaroo Cloud Environment guide. Users will have to manage the network settings, port forward, and other settings for their cloud environment.

Install Wallaroo

Wallaroo Enterprise can be installed either interactively or automatically through the kubectl and kots applications.

Automated Install

The Interactive Install process allows users to install Wallaroo through a command line prompt with the default settings. This is useful if the network and port forwards are not set up to allow remote users access to the Wallaroo Administrative Dashboard through a browser.

  1. Install the Wallaroo Enterprise Edition using kots install wallaroo/ea, specifying the namespace to install Wallaroo into. Include the following flags:
    1. --license-file {License File}: Specify the license file for the new Wallaroo Enterprise instance.
    2. --shared-password {My Admin Password}: Set the Wallaroo Administrative Dashboard password during installation.

Interactive Install

The Interactive Install process allows users to adjust the configuration settings before Wallaroo is deployed. It requires users be able to access the Wallaroo Administrative Dashboard through a browser.

  1. Install the Wallaroo Enterprise Edition using kots install wallaroo/ea, specifying the namespace to install Wallaroo into. For example, if wallaroo is the namespace, then the command is:

    kubectl kots install wallaroo/ea --namespace wallaroo
  2. Wallaroo Enterprise Edition will be downloaded and installed into your Kubernetes environment in the namespace specified. When prompted, set the default password for the Wallaroo environment. When complete, Wallaroo Enterprise Edition will display the URL for the Admin Console, and how to end the Admin Console from running.

    • Deploying Admin Console
    • Creating namespace ✓
    • Waiting for datastore to be ready ✓
        Enter a new password to be used for the Admin Console: •••••••••••••
      • Waiting for Admin Console to be ready ✓
    • Press Ctrl+C to exit
    • Go to http://localhost:8800 to access the Admin Console


Once installed, Wallaroo will continue to run until terminated.

To relaunch the Wallaroo Administrative Dashboard and make changes or updates, use the following command:

kubectl-kots admin-console --namespace wallaroo

DNS Services

Wallaroo Enterprise requires integration into your organizations DNS services, and is completed in the next step.

Install Wallaroo

With the environment prepared, Wallaroo can now be installed.

Step Status
Setup Environment COMPLETED!
Install Wallaroo Enterprise
Integrate Wallaroo with DNS Services Update Wallaroo post-install