> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/self-managed-enterprise-edition/use-self-managed-enterprise-edition/smp-installationupgrade/operator-installation/troubleshooting.md).

# Support and troubleshooting

This topic describes the issues you are most likely to hit when you install the Harness SMP Operator, and how to resolve them.

***

### Common installation issues <a href="#common-installation-issues" id="common-installation-issues"></a>

Each entry names the usual cause, gives a command that confirms it, and states the fix. Run the **Check** command first to confirm that you are looking at the right problem, then apply the **Fix**.

#### Operator pods stuck in ImagePullBackOff <a href="#operator-pods-stuck-in-imagepullbackoff" id="operator-pods-stuck-in-imagepullbackoff"></a>

* **Cause**: Images are not accessible from the cluster (wrong registry, missing credentials, or images not mirrored).
* **Check**: `kubectl describe pod -n harness platform-installer-0 | grep -A5 Events`
* **Fix**: Verify registry credentials and ensure all required images are pushed. Go to [Registry setup](/self-managed-enterprise-edition/use-self-managed-enterprise-edition/smp-installationupgrade/operator-installation/prerequisites/registry-setup.md) to review the registry requirements.

#### DNS not resolving <a href="#dns-not-resolving" id="dns-not-resolving"></a>

* **Cause**: DNS record not pointing to the load balancer or ingress external IP.
* **Check**: `nslookup <YOUR_DNS>`
* **Fix**: Create an A or CNAME record pointing to the external IP of your ingress service (`kubectl get svc -n harness`).

#### Platform PVCs stuck in Pending <a href="#platform-pvcs-stuck-in-pending" id="platform-pvcs-stuck-in-pending"></a>

* **Cause**: Storage class does not exist or no dynamic provisioner is available.
* **Check**: `kubectl get pvc -n harness`
* **Fix**: Verify the storage class exists (`kubectl get storageclass`) and matches the value passed through `--pi-set cluster.tfi.storageClass=<name>`. Go to [Storage classes](/self-managed-enterprise-edition/use-self-managed-enterprise-edition/smp-installationupgrade/operator-installation/prerequisites/storage-classes.md) to review the supported storage classes.

#### Installer UI not accessible <a href="#installer-ui-not-accessible" id="installer-ui-not-accessible"></a>

* **Cause**: Ingress or VirtualService not configured correctly, or TLS certificate issue.
* **Check**: `kubectl get ingress -n harness` (nginx) or `kubectl get vs -n harness` (Istio)
* **Fix**: Verify the ingress resource exists and the external IP is reachable. Check the TLS secret with `kubectl get secret -n harness | grep tls`.

***

### Get support <a href="#get-support" id="get-support"></a>

Contact [Harness Support](mailto:support@harness.io) if the entries above do not resolve your issue.

***

### Related articles <a href="#related-articles" id="related-articles"></a>

* [Prerequisites](/self-managed-enterprise-edition/use-self-managed-enterprise-edition/smp-installationupgrade/operator-installation/prerequisites/index.md): Cluster, storage, registry, and DNS requirements to confirm before you install.
* [Post-installation checks](/self-managed-enterprise-edition/use-self-managed-enterprise-edition/smp-installationupgrade/operator-installation/install/post-installation-checks.md): Verify that each part of the deployment came up correctly.
* [CLI reference](/self-managed-enterprise-edition/use-self-managed-enterprise-edition/smp-installationupgrade/operator-installation/cli-reference.md): Installation parameters for the helm and clustermgr flows.