Quickstart (Existing Cluster)
tip
For in-depth custom installation setup and cluster operations, please check out the Administrator Guide.
StackBlitz Enterprise is a Kubernetes application. You can follow these instructions to install the software on an existing Kubernetes cluster. Alternatively, if you don't have Kubernetes set up for your organization, you can use our installer that has an embedded production-ready Kubernetes distribution packaged with it. You can view the Quickstart on Bare Metal for a quick way to get up and running without Kubernetes. Installing on an existing cluster is the recommended way of installing StackBlitz Enterprise. For installing StackBlitz in environments with restricted network access, see Air-Gapped Installs.
Getting started on an Existing Cluster
Minimum Cluster Requirements:
- 8 vCPU
- 32 GB Memory
- 200 GB Storage
kubectl
access to the cluster- Internet access from the cluster (see Configuring Firewall Rules for the list of hostnames/ips that require internet access for installation, updates and licensing)
- A machine with
kubectl
access to the cluster.
important
If your cluster does not allow access to the external internet, you will need to perform an Air-Gapped Install. Contact enterprise@stackblitz.com if you need air-gapped installations enabled on your license.
Recommended Cluster Requirements:
- 16 vCPU
- 40 GB Memory
Make sure ports the following TCP ports are allowed to the Cluster:
- 22
- 80
- 443
- 8800
- 30902
- 8080
- 6443
StackBlitz uses Kots to manage the installation, licensing, and delivery of updates. On a machine that has kubectl
access to the cluster, install the kots
CLI with the following command:
Then, install the Admin Console for StackBlitz by running this command:
You will be prompted for a namespace in your cluster to install stackblitz in. By default the namespace is stackblitz
. You will eventually be prompted to set a password for the Admin Console:
After choosing a submitting, the
Navigate to http://localhost:8800 to access the Admin Console. You will be prompted to log in using the password you chose before.
tip
To access the Admin Console again, run kubectl kots admin-console --namespace stackblitz
(replacing stackblitz
with your namespace)
License registration
After logging in to the Admin Console, you'll be prompted for a License.
Drag and drop your license file onto the webpage to upload it. Once this step completes, you should be presented with EE site configuration screen. It should look like this:
See the Config Options in the Administrator Guide for more details on each configuration option. After filling out the configuration fields, click "Continue". Your configuration will be saved and the Admin Console will deploy your configuration and begin to pull and run the images for StackBlitz. After your instance is up and running, you will need to Configure DNS Settings to point your DNS zones at the IP/CNAME of your ingress.