---
title: Troubleshoot Kubernetes
---

# Troubleshoot Kubernetes

Use this section to resolve common issues with E2E Kubernetes clusters - both portal/cluster-level problems and in-cluster workload problems.

---

## Cluster and Portal Issues

| Symptom                                    | Likely cause and fix                                                                                                                                                                                                                       |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Cluster creation fails or hangs            | A security group missing **TCP 6443** / **UDP 8472**, insufficient credits, or a temporarily unavailable plan. Check the attached [security group](/docs/myaccount/kubernetes/manage/security-groups) and your credit balance, then retry. |
| `kubectl` cannot connect                   | The attached security group must allow **TCP port 6443**. Confirm the kubeconfig is current - see [Connect to a Cluster](/docs/myaccount/kubernetes/getting-started/connect-to-cluster).                                                   |
| Kubernetes option not offered in a region  | Kubernetes is not available in the **Mumbai** location. Use a supported region.                                                                                                                                                            |
| Master plan upgrade is disabled or blocked | The cluster must be **Running**, not Creating/Terminating, and you must have enough credits. Only higher-tier plans in the same series are offered. See [Actions](/docs/myaccount/kubernetes/manage/actions#upgrade-master-plan).          |
| Cannot delete a worker node                | You cannot go below the pool minimum (**2** for compute, **1** for GPU). Delete the whole pool instead. See [Node Pools](/docs/myaccount/kubernetes/manage/node-pools#worker-node-actions).                                                |
| SSL certificate about to expire            | Renew from the [Cluster Details](/docs/myaccount/kubernetes/manage/cluster-details#ssl-certificate-renewal) tab, or let it auto-renew.                                                                                                     |
| A tab shows "please wait"                  | The cluster is **Creating** or **Upgrading Master**. Most tabs become usable once it is **Running**.                                                                                                                                       |

---

## Workload Issues

In-cluster workload problems and their fixes:

| Issue                               | Guide                                                                            |
| ----------------------------------- | -------------------------------------------------------------------------------- |
| Pods crash and restart repeatedly   | [CrashLoopBackOff](/docs/myaccount/kubernetes/troubleshoot/crashloopbackoff)     |
| Image cannot be pulled              | [ImagePullBackOff](/docs/myaccount/kubernetes/troubleshoot/imagepullbackoff)     |
| A node shows NotReady               | [Node Not Ready](/docs/myaccount/kubernetes/troubleshoot/node-not-ready)         |
| Pods killed for memory              | [OOMKilled](/docs/myaccount/kubernetes/troubleshoot/oomkilled)                   |
| Pods stay Pending / cannot schedule | [Pod Unschedulable](/docs/myaccount/kubernetes/troubleshoot/pod-unschedulable)   |
| PVC stuck in Pending                | [PVC Pending](/docs/myaccount/kubernetes/troubleshoot/pvc-pending)               |
| Istio resources not creating        | [Istio Not Creating](/docs/myaccount/kubernetes/troubleshoot/istio-not-creating) |

---

## Related Resources

| Resource                                                                              | Use it for                   |
| ------------------------------------------------------------------------------------- | ---------------------------- |
| [Manage Kubernetes](/docs/myaccount/kubernetes/manage)                                | The full management surface. |
| [Connect to a Cluster](/docs/myaccount/kubernetes/getting-started/connect-to-cluster) | kubeconfig and access.       |
| [Kubernetes Guides](/docs/myaccount/kubernetes/guides)                                | In-cluster how-to guides.    |