# Upgrade Nected Version

This guide explains how to upgrade your self-hosted Nected instance to a newer version using Helm. The upgrade process applies to any Kubernetes-based deployment and ensures that your services, configuration, and data remain intact during the version transition.

{% hint style="warning" %}
**Before proceeding, ensure that you have:**

* Backed up your `nected-values.yaml` file.
* Verified that all services are healthy using `kubectl get pods`.
* Taken a backup of your PostgreSQL and Redis databases if upgrading across major versions.
  {% endhint %}

### Step 1: Update the Latest Helm Chart

To make sure you're using the latest Helm chart for Nected:

```bash
helm repo update nected
```

### Step 2: Review the Change Log

Before upgrading, review the [Nected Release Notes](https://github.com/nected/helm-charts/releases) to:

* Identify new configuration keys
* Check for breaking changes
* Note any deprecations or removals

Update your values files accordingly.

### Step 3: Apply the Upgrade

To upgrade the **Nected core application**, run:

```bash
helm upgrade nected nected/nected -f values/nected-values.yaml
```

> This command will pull the latest Helm charts and apply them to your running cluster while preserving your configuration.

***

### Step 4: Verify the Upgrade

After the upgrade completes:

1. Run `kubectl get pods` to ensure all pods are in `Running` or `Completed` state.
2. Visit your UI domain (e.g., `https://app.yourdomain.com`) and verify the platform is accessible.
3. Optionally, inspect logs to validate post-upgrade stability:

```bash
kubectl logs -l app=nected-nalanda
kubectl logs -l app=nected-vidhaan-router
```

### Rollback (if needed)

If an issue occurs after upgrading, you can roll back to the previous stable release:

```bash
helm rollback nected <REVISION_NUMBER>
```

Use `helm history <release-name>` to list past revisions:

```bash
helm history nected
```

### Need Help?

If you encounter issues or have upgrade-specific questions, contact the Nected team at <assist@nected.ai>.