Skip to main content
Version: 1.22


Okteto provides a diagnostics tool through the Replicated Troubleshoot framework. This tool is completely optional but can help troubleshoot complex issues, specially if you are getting assistance through Okteto Support.

Starting in Okteto 1.16, as part of the helm installation we deploy a okteto-support-bundle configmaps in the okteto namespace that contain the specs to create a support bundle.


The support-bundle provided by Replicated Troubleshoot is a client-side utility, packaged as a kubectl plugin and distributed through the krew package manager. Make sure to have it installed as per the installation guide


Run kubectl krew to check the installation and make sure krew is in your $PATH as described in the installation guide

Once krew is installed, you can install the kubectl plugin:

kubectl krew install support-bundle

More info about the installation here.

Support bundle

Creates a gzipped tarball which includes cluster information, logs for okteto components, and other relevant information. This bundle can help troubleshoot issues with the cluster specially during an incident in which you are getting assistance from Okteto Support.

kubectl support-bundle \
--interactive=false \
--debug \
-n okteto \

The default file name for the bundle is support-bundle-TIMESTAMP.tar.gz but it can be overridden with -o <filename>. More info about the support bundle command, extra arguments, etc can be found here: