# Deploying on Kubernetes with Helm

## Install

A Tonic Structural Helm chart is located at: <https://github.com/TonicAI/tonic_helm_charts>.

To use the Helm chart, you can either:

* Use the [OCI-based registry](https://helm.sh/docs/topics/registries/#using-an-oci-based-registry) that Tonic hosts on [Quay.io](https://quay.io/).
* Fork or clone the repository and then maintain it locally.

The Structural images are hosted on [Quay.io.](https://quay.io/) During the onboarding period, you are provided access credentials to our repositories. If you require new credentials, or you experience issues accessing the repository, contact <support@tonic.ai>.

## Configure

Before you deploy Structural, you create a **values.yaml** file with the configuration for your instance.

For details about the required and optional configuration options, go to the [repository readme](https://github.com/TonicAI/tonic_helm_charts#configuration).

## Deploy

To deploy and validate access to Structural from the forked repository, follow the [instructions in the repository readme](https://github.com/TonicAI/tonic_helm_charts#deploy).

To use the OCI-based registry, run:

{% code overflow="wrap" %}

```
helm install structural oci://quay.io/tonicai/structural -f values.yaml -n structural --create-namespace
```

{% endcode %}

## Update

Structural notifies you when the current version is more than 10 versions behind the most recent release. The notification is on the **System Status** tab of **Structural Settings** view.

Before you update, make sure to back up your Structural application database.

To get the latest Structural version, users with the **Update Tonic** global permission can use the [in-app update feature](/app/admin/updating-tonic.md).&#x20;

Alternatively, if you need to specify a particular version of Structural to use, set [`tonicVersion`](https://github.com/TonicAI/tonic_helm_charts#version), then run the following:

```
$ helm upgrade <name_of_release> -n <namespace_name> <path-to-helm-chart>
```

To upgrade using the OCI-based repository, run:

{% code overflow="wrap" %}

```
helm upgrade -n structural structural oci://quay.io/tonicai/structural -f values.yaml --version "1.${TONIC_RELEASE}.0"
```

{% endcode %}

{% hint style="info" %}
When you make changes to your deployment with Helm, if your `tonicVersion` tag is `latest`, make sure that you update all of your individual pods/containers to the same version.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tonic.ai/app/admin/on-premise-deployment/deploying-with-helm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.