Skip to main content

Installing AtScale

The following sections describe how to install the AtScale Helm chart.

note

If needed, you can download the AtScale images prior to installing. For the full list of current images, see Current List of AtScale Images.

Prerequisites​

Before you can install AtScale, you must have the following:

  • A Kubernetes cluster that meets the requirements described in System Requirements.
  • Helm 3+ installed.
  • A TLS certificate. This is required even if you do not enable TLS for AtScale. The certificate can be self-signed and does not need to be valid.
  • RBAC authentication enabled on your cluster and cluster permissions configured, as described in Configuring Cluster Permissions.
  • Volume resizing enabled on your cluster, as described in Enabling Volume Resizing.
  • A values override file. For more information, see Creating a Values Override File.

Install AtScale​

Once you have any necessary configuration defined, you can install AtScale. Open a terminal window and run the following:

helm install atscale oci://docker.io/atscaleinc/atscale --version <version> -n <namespace> --create-namespace -f <override_file>

Where:

  • <version> is the version of AtScale to install; for example, 2024.1.1.
  • <namespace> is the namespace in which you want to install AtScale.
  • <override_file> is the values override file you created above.

For example:

helm install atscale oci://docker.io/atscaleinc/atscale --version 2024.9.0 -n atscale --create-namespace -f ./values.yaml

Configure your DNS​

After installing AtScale, you must configure your DNS. This will require either the IP address or hostname of the atscale service.

To obtain this information, open a terminal window and run the following command:

kubectl get service -n atscale nginx

You can then use the returned value to create either an A record (if the value is an IP address) or a CNAME record (if the value is a hostname).

Next Steps​

Once you have AtScale up and running, you should do the following: