# Okteto Self-Hosted

**URL:** https://community.okteto.com/c/okteto-self-hosted/9.md

[Latest](https://community.okteto.com/latest.md) · [Categories](https://community.okteto.com/categories.md) · [Tags](https://community.okteto.com/tags.md)

---

## [About the Okteto Self-Hosted category](https://community.okteto.com/t/about-the-okteto-self-hosted-category/29)

<div class="topic-metadata">

**Author:** [@arsh](https://community.okteto.com/u/arsh)\
**Replies:** 0

</div>

All questions related to Okteto Self Hosted go here. We’re here to help you with everything from installation to any administration-related queries you might have!

---

## [Issue with new SSH Known Hosts feature – host registered but still not found](https://community.okteto.com/t/issue-with-new-ssh-known-hosts-feature-host-registered-but-still-not-found/1431)

<div class="topic-metadata">

**Author:** [@marticardus](https://community.okteto.com/u/marticardus)\
**Replies:** 12\
**Last updated:** [October 27, 2025, 10:04am UTC](https://community.okteto.com/t/issue-with-new-ssh-known-hosts-feature-host-registered-but-still-not-found/1431 "2025-10-27T10:04:26Z")

</div>

Hi everyone, I’ve been testing the new SSH Known Hosts feature, but I’m running into some issues. Even though I’ve registered my known host according to the documentation, Okteto keeps returning errors saying that the …

---

## [Problems with deployin an AI Agent when using a pre-existing Ingress Controller](https://community.okteto.com/t/problems-with-deployin-an-ai-agent-when-using-a-pre-existing-ingress-controller/1424)

<div class="topic-metadata">

**Author:** [@marticardus](https://community.okteto.com/u/marticardus)\
**Replies:** 6\
**Last updated:** [October 9, 2025, 5:30am UTC](https://community.okteto.com/t/problems-with-deployin-an-ai-agent-when-using-a-pre-existing-ingress-controller/1424 "2025-10-09T05:30:16Z")

</div>

Hello I configured Okteto following the following manuals and documentation, resulting in the helm values ​​file I’ve added at the end as well. I can access the Okteto web interface, but I’m unable to run any environme…

---

## [AWS IAM role requirements](https://community.okteto.com/t/aws-iam-role-requirements/1248)

<div class="topic-metadata">

**Author:** [@shirvan](https://community.okteto.com/u/shirvan)\
**Replies:** 1\
**Last updated:** [April 16, 2024, 6:17am UTC](https://community.okteto.com/t/aws-iam-role-requirements/1248 "2024-04-16T06:17:46Z")

</div>

Hello, I’m trying to configure the deployment to use a custom service role. Looking at the docs there is no indication of what access is required by the pods or where the role should be specified in the helm chart, spec…

---

## [Helm installation fails due to an error in the wildard-certificate.yaml template file](https://community.okteto.com/t/helm-installation-fails-due-to-an-error-in-the-wildard-certificate-yaml-template-file/1120)

<div class="topic-metadata">

**Author:** [@ramiro](https://community.okteto.com/u/ramiro)\
**Replies:** 1\
**Last updated:** [November 28, 2023, 9:01pm UTC](https://community.okteto.com/t/helm-installation-fails-due-to-an-error-in-the-wildard-certificate-yaml-template-file/1120 "2023-11-28T21:01:03Z")

</div>

When trying to install Okteto Self-Hosted 1.15.0, I get the following error: Error: template: okteto/templates/wildcard-certificate.yaml:2:29: executing "okteto/templates/wildcard-certificate.yaml" at \<include "okteto.w…

---

## [Okteto Self-hosted: License Key Requirement in Version 1.13](https://community.okteto.com/t/okteto-self-hosted-license-key-requirement-in-version-1-13/1060)

<div class="topic-metadata">

**Author:** [@Ashlynn](https://community.okteto.com/u/Ashlynn)\
**Replies:** 0\
**Last updated:** [September 27, 2023, 9:17pm UTC](https://community.okteto.com/t/okteto-self-hosted-license-key-requirement-in-version-1-13/1060 "2023-09-27T21:17:18Z")

</div>

Hello Community :wave: We hope you’re all doing well and building awesome things. We have an important update to share with you regarding the Okteto Self-hosted product. Starting with Okteto Version 1.13, a License Key…

---

## [Velero backup considerations](https://community.okteto.com/t/velero-backup-considerations/1036)

<div class="topic-metadata">

**Author:** [@jona](https://community.okteto.com/u/jona)\
**Replies:** 1\
**Last updated:** [August 30, 2023, 8:19pm UTC](https://community.okteto.com/t/velero-backup-considerations/1036 "2023-08-30T20:19:08Z")

</div>

Are there any considerations that self-hosted okteto clusters can to take into account for the implementation of Velero backup and restoration?

---

## [How do I configure Okteto to use an existing ingress-nginx?](https://community.okteto.com/t/how-do-i-configure-okteto-to-use-an-existing-ingress-nginx/995)

<div class="topic-metadata">

**Author:** [@ramiro](https://community.okteto.com/u/ramiro)\
**Replies:** 1\
**Last updated:** [August 9, 2023, 8:07am UTC](https://community.okteto.com/t/how-do-i-configure-okteto-to-use-an-existing-ingress-nginx/995 "2023-08-09T08:07:29Z")

</div>

I have a cluster that comes with ingress-nginx pre-installed. Is it possible to configure Okteto to use that ingress instead of installing a second one?

---

## [Node affinity blocking scheduling](https://community.okteto.com/t/node-affinity-blocking-scheduling/975)

<div class="topic-metadata">

**Author:** [@benjoldersma](https://community.okteto.com/u/benjoldersma)\
**Replies:** 7\
**Last updated:** [August 3, 2023, 9:36pm UTC](https://community.okteto.com/t/node-affinity-blocking-scheduling/975 "2023-08-03T21:36:15Z")

</div>

Hey y’all, sorry to keep pestering. We’re seeing an odd behavior with just one of our okteto manifests - the dev image/container can’t start, due to a Kubernetes scheduling issue. We’re getting this error: 0/2 nodes a…

---

## [Improve build performance by persisting the Buildkit cache layers message](https://community.okteto.com/t/improve-build-performance-by-persisting-the-buildkit-cache-layers-message/976)

<div class="topic-metadata">

**Author:** [@benjoldersma](https://community.okteto.com/u/benjoldersma)\
**Replies:** 5\
**Last updated:** [August 3, 2023, 7:29am UTC](https://community.okteto.com/t/improve-build-performance-by-persisting-the-buildkit-cache-layers-message/976 "2023-08-03T07:29:18Z")

</div>

We’re seeing this pending task in our admin UI: “Improve build performance by persisting the Buildkit cache layers.” I’ve looked through the linked documentation, and have tried setting it to this: buildkit: ingress…

---

## [Possible to get a list of docker images that are published to our okteto registry?](https://community.okteto.com/t/possible-to-get-a-list-of-docker-images-that-are-published-to-our-okteto-registry/968)

<div class="topic-metadata">

**Author:** [@benjoldersma](https://community.okteto.com/u/benjoldersma)\
**Replies:** 13\
**Last updated:** [August 1, 2023, 4:37pm UTC](https://community.okteto.com/t/possible-to-get-a-list-of-docker-images-that-are-published-to-our-okteto-registry/968 "2023-08-01T16:37:35Z")

</div>

Hi! Been a minute. We somehow horked our self-hosted installation during an upgrade, and now we’re seeing some errors like this in our preview environments: container 'migrate' image 'registry.dev.upshift.earth/pr-81/fu…

---

## [Helm install fails. "buildkit cert is not available"](https://community.okteto.com/t/helm-install-fails-buildkit-cert-is-not-available/915)

<div class="topic-metadata">

**Author:** [@dmccorma](https://community.okteto.com/u/dmccorma)\
**Replies:** 3\
**Last updated:** [July 13, 2023, 6:15pm UTC](https://community.okteto.com/t/helm-install-fails-buildkit-cert-is-not-available/915 "2023-07-13T18:15:35Z")

</div>

Hello. I had a functioning install of Okteto self-hosted, running in a 1.26 EKS cluster. I tore down and rebuilt the cluster today, and attempted to reinstall Okteto using the same configuration as before (using Helm via…

---

## [Okteto daemon error in k3s on lxd/lxc](https://community.okteto.com/t/okteto-daemon-error-in-k3s-on-lxd-lxc/821)

<div class="topic-metadata">

**Author:** [@unreg](https://community.okteto.com/u/unreg)\
**Replies:** 4\
**Last updated:** [May 16, 2023, 5:13pm UTC](https://community.okteto.com/t/okteto-daemon-error-in-k3s-on-lxd-lxc/821 "2023-05-16T17:13:35Z")

</div>

Hi! I have install self-hosted Okteto on k3s in lxd/lxc. And i have error with okteto-daemon: {"level":"fatal","service":"daemon","error":"open /proc-aux/sys/fs/inotify/max\_user\_watches: permission denied","message":"t…

---

## [Docker-compose mongodb error](https://community.okteto.com/t/docker-compose-mongodb-error/685)

<div class="topic-metadata">

**Author:** [@iomilovanderpas](https://community.okteto.com/u/iomilovanderpas)\
**Replies:** 2\
**Last updated:** [April 6, 2023, 11:59am UTC](https://community.okteto.com/t/docker-compose-mongodb-error/685 "2023-04-06T11:59:53Z")

</div>

Hey guys, When I try to build a preview environment for my microservices I get this error: x Error building service 'mongodb': error building image 'registry.cloud.okteto.net/pr-1-iomilovanderpas/flex-app-portal-backe…

---

## [Okteto Self Hosted - Helm installation fails](https://community.okteto.com/t/okteto-self-hosted-helm-installation-fails/606)

<div class="topic-metadata">

**Author:** [@tuxomaster](https://community.okteto.com/u/tuxomaster)\
**Replies:** 2\
**Last updated:** [February 16, 2023, 4:53pm UTC](https://community.okteto.com/t/okteto-self-hosted-helm-installation-fails/606 "2023-02-16T16:53:51Z")

</div>

Facing this error when installing okteto with helm charts. This k8s cluster already has nginx working as the ingress controller serving apps. The current ingress class used is “nginx” Please help. Error: INSTALLATION F…

---

## [Okteto Registry pods restarting](https://community.okteto.com/t/okteto-registry-pods-restarting/608)

<div class="topic-metadata">

**Author:** [@tuxomaster](https://community.okteto.com/u/tuxomaster)\
**Replies:** 1\
**Last updated:** [February 16, 2023, 3:18pm UTC](https://community.okteto.com/t/okteto-registry-pods-restarting/608 "2023-02-16T15:18:02Z")

</div>

Okteto registry pods are in crashloopbackoff with the following error. kubectl logs -f okteto-registry-BBBBB-xxxx configuration error: error parsing /etc/docker/registry/config.yml: no storage configuration provided Us…

---

## [Okteto Webhook network policy for GKE private clusters](https://community.okteto.com/t/okteto-webhook-network-policy-for-gke-private-clusters/538)

<div class="topic-metadata">

**Author:** [@provecho](https://community.okteto.com/u/provecho)\
**Replies:** 0\
**Last updated:** [January 11, 2023, 5:38pm UTC](https://community.okteto.com/t/okteto-webhook-network-policy-for-gke-private-clusters/538 "2023-01-11T17:38:44Z")

</div>

When installing Okteto Self-Hosted on a GKE private cluster, with network policies enabled and having a default empty ingress network policy for all pods in the okteto namespace, allowing ingress traffic to a specific co…

---

## [Authentication handshake failed during okteto build](https://community.okteto.com/t/authentication-handshake-failed-during-okteto-build/448)

<div class="topic-metadata">

**Author:** [@benjoldersma](https://community.okteto.com/u/benjoldersma)\
**Replies:** 5\
**Last updated:** [December 19, 2022, 11:01pm UTC](https://community.okteto.com/t/authentication-handshake-failed-during-okteto-build/448 "2022-12-19T23:01:58Z")

</div>

I’m getting this error “all of a sudden” :slight\_smile: I’m sure I misconfigured something. but… the SSL certificate for https://registry.dev.upshift.earth doesn’t seem cranky… It’s preventing me from building with okte…

---

## [Troubleshooting install - okteto-buildkit-xxx pod stuck in pending](https://community.okteto.com/t/troubleshooting-install-okteto-buildkit-xxx-pod-stuck-in-pending/429)

<div class="topic-metadata">

**Author:** [@benjoldersma](https://community.okteto.com/u/benjoldersma)\
**Replies:** 3\
**Last updated:** [December 17, 2022, 12:42am UTC](https://community.okteto.com/t/troubleshooting-install-okteto-buildkit-xxx-pod-stuck-in-pending/429 "2022-12-17T00:42:00Z")

</div>

I’m seeing a couple of issues after running through the okteto self-hosted install. okteto-registry-xxx pod is in CrashLoopBackOff. here is a log: │ Events: …

---

## [Is Kubernetes 1.23.12 supported?](https://community.okteto.com/t/is-kubernetes-1-23-12-supported/406)

<div class="topic-metadata">

**Author:** [@scheung38](https://community.okteto.com/u/scheung38)\
**Replies:** 1\
**Last updated:** [December 8, 2022, 4:53pm UTC](https://community.okteto.com/t/is-kubernetes-1-23-12-supported/406 "2022-12-08T16:53:48Z")

</div>

Since it says 1.21 to 1.23?

---

## [Kubectl create secret generic okteto-cloud-secret fails not found but okteto namespace create: reserved?](https://community.okteto.com/t/kubectl-create-secret-generic-okteto-cloud-secret-fails-not-found-but-okteto-namespace-create-reserved/374)

<div class="topic-metadata">

**Author:** [@scheung38](https://community.okteto.com/u/scheung38)\
**Replies:** 0\
**Last updated:** [November 24, 2022, 2:59am UTC](https://community.okteto.com/t/kubectl-create-secret-generic-okteto-cloud-secret-fails-not-found-but-okteto-namespace-create-reserved/374 "2022-11-24T02:59:00Z")

</div>

kubectl create secret generic okteto-cloud-secret --namespace=okteto --from-literal=key=STORAGE\_ACCOUNT\_ACCESS\_KEY error: failed to create secret namespaces “okteto” not found But okteto namespace create okteto x The…

---

## [Issues with okteto-api reading wildcard SSL cert](https://community.okteto.com/t/issues-with-okteto-api-reading-wildcard-ssl-cert/325)

<div class="topic-metadata">

**Author:** [@pmarks](https://community.okteto.com/u/pmarks)\
**Replies:** 7\
**Last updated:** [November 8, 2022, 10:13pm UTC](https://community.okteto.com/t/issues-with-okteto-api-reading-wildcard-ssl-cert/325 "2022-11-08T22:13:15Z")

</div>

Hello everyone! I have been playing with Okteto for a few days along with a coworker since meeting the team at KubeCon, and so far we like what we see, but are trying to pass a roadblock on setting up our product inside…

---

## [How To configure Okteto with Azure OpenID Connect?](https://community.okteto.com/t/how-to-configure-okteto-with-azure-openid-connect/281)

<div class="topic-metadata">

**Author:** [@MarcinS](https://community.okteto.com/u/MarcinS)\
**Replies:** 3\
**Last updated:** [October 5, 2022, 8:24am UTC](https://community.okteto.com/t/how-to-configure-okteto-with-azure-openid-connect/281 "2022-10-05T08:24:09Z")

</div>

Just like in title if you could provide me with instructions how to configure auth: section in Okteko config file and, a service principle on Azure side it self. So far with configuration below I got “Service unavailable…

---

## [Installing Okteto helm chart cause all outbound connections to be routed to the Ingress](https://community.okteto.com/t/installing-okteto-helm-chart-cause-all-outbound-connections-to-be-routed-to-the-ingress/207)

<div class="topic-metadata">

**Author:** [@dmccorma](https://community.okteto.com/u/dmccorma)\
**Replies:** 2\
**Last updated:** [August 17, 2022, 5:19pm UTC](https://community.okteto.com/t/installing-okteto-helm-chart-cause-all-outbound-connections-to-be-routed-to-the-ingress/207 "2022-08-17T17:19:30Z")

</div>

I’ve installed a proof-of-concept Okteto installation in a test EKS cluster at AWS. There is nothing else installed in the cluster, other than a few basics like aws-load-balancer-controller etc. When the helm chart is i…
