Proof-of-Concept Installation

The main purpose of the proof-of-concept installation is to get acquainted with Space on-premises configuration before installing Space to a production environment. It implies that you install all Space on-premises components to a Kubernetes cluster on a local machine. For example, you can do this with Docker Desktop on macOS and Windows and with minikube on Linux. This guide shows Space installation using Docker Desktop on macOS.

To perform the proof-of-concept installation, you should use the deployment script that lets you interactively configure main cluster settings. The result of the script is not only a working cluster but also a YAML values file. You can use this file as a guide on required cluster settings.

Prerequisites

Software requirements

You must have the following software installed on the target machine:

Docker Desktop (macOS or Windows), minikube (Linux)
Helm 3.7 or later
The kubectl tool
OpenSSL

Performing the proof-of-concept installation

Download the deployment script.
Grant execution permissions to the script file:
chmod +x ./deploy_interactive.sh
Configure Docker:
- Open Docker Desktop, then open Settings.
- In the Kubernetes page, select Enable Kubernetes.
- In the Resources page, provide Docker with at least 12 GB of memory and 6 CPU cores.
Run the deployment script:
./deploy_interactive.sh
When asked for the kubectl context, leave the default value: docker-desktop.
When asked for the environment, leave the default one: local.
Follow other installation steps. Note that after the script finishes the installation, it may take some time for the Space components to start.
Open your Space on-premises instance in a browser. The default URL is http://lvh.me.
Perform post-installation steps.

Last modified: 27 December 2021