Skip to main content
Version: 1.10

Deploy your Okteto instance

Configuration file

Before running helm install, we recommend that you create a yaml configuration file with your choices about how to install Okteto. This guide will walk you through the default installation. A complete list of configuration options is available here.

You can use this sample configuration file as a starting point. The different configuration settings are explained below.

Cluster Endpoint

This is the public endpoint of your Kubernetes cluster. It will be used by Okteto when generating Kubeconfig credentials for your users.

cluster:
endpoint: "https://52.30.32.1"

Run the following command to obtain your cluster's API server endpoint:

kubectl config view --minify | grep server

License

Okteto is free for small teams. You get all the features of Okteto for up to 3 users.

license: XXXXX

Want to use Okteto with a bigger team? Let's talk

Deploy the Okteto Chart

Run helm install to deploy your Okteto instance. In this example, we have named our Helm release okteto.

$ helm repo add okteto https://charts.okteto.com
$ helm repo update
$ helm install okteto okteto/okteto -f config.yaml --namespace=okteto --create-namespace

You can also use --version version if you would like to install a specific version of Okteto.

After a few seconds, all the resources will be created. The output will look something like this:

Congratulations! Okteto is successfully installed!

Follow these steps to access your Okteto instance:

1. Start a port-forward to the ingress service by running:

$ sudo kubectl port-forward service/okteto-ingress-nginx-controller 443:443 --namespace okteto

2. Access your Okteto instance at https://okteto.localtest.me/login#token=******

Follow these steps to configure the Okteto CLI:

1. Install the Okteto CLI:

$ curl https://get.okteto.com -sSfL | sh

2. Configure the Okteto CLI context:

$ okteto context use https://okteto.localtest.me --token ****** --insecure-skip-tls-verify

3. You're all set to complete our getting started guide:

https://www.okteto.com/docs/using-dev-envs/

Happy coding!

Once the chart is installed, follow the onscreen instructions to finalize the configuration.

Important: The default installation is not recommended for production use. We highly advise following the steps outlined in the Admin Dashboard before giving your team access to your Okteto instance.