troubleshooting.md

PLEASE NOTE: This document applies to the HEAD of the source tree

If you are using a released version of Kubernetes, you should refer to the docs that go with that version.

The latest 1.0.x release of this document can be found [here](http://releases.k8s.io/release-1.0/docs/troubleshooting.md).

Documentation for other releases can be found at releases.k8s.io.

Troubleshooting

Sometimes things go wrong. This guide is aimed at making them right. It has two sections:

• Troubleshooting your application - Useful for users who are deploying code into Kubernetes and wondering why it is not working.
• Troubleshooting your cluster - Useful for cluster administrators and people whose Kubernetes cluster is unhappy.

You should also check the known issues for the release you're using.

Getting help

If your problem isn't answered by any of the guides above, there are variety of ways for you to get help from the Kubernetes team.

Questions

If you aren't familiar with it, many of your questions may be answered by the user guide.

We also have a number of FAQ pages:

• User FAQ
• Debugging FAQ
• Services FAQ

You may also find the Stack Overflow topics relevant:

• Kubernetes
• Google Container Engine - GKE

Help! My question isn't covered! I need help now!

Stack Overflow

Someone else from the community may have already asked a similar question or may be able to help with your problem. The Kubernetes team will also monitor posts tagged kubernetes. If there aren't any existing questions that help, please ask a new one!

Slack

The Kubernetes team hangs out on Slack in the #kubernetes-users channel. You can participate in the Kubernetes team here. Slack requires registration, but the Kubernetes team is open invitation to anyone to register here. Feel free to come and ask any and all questions.

Mailing List

The Google Container Engine mailing list is [email protected]

Bugs and Feature requests

If you have what looks like a bug, or you would like to make a feature request, please use the Github issue tracking system.

Before you file an issue, please search existing issues to see if your issue is already covered.

If filing a bug, please include detailed information about how to reproduce the problem, such as:

• Kubernetes version: kubectl version
• Cloud provider, OS distro, network configuration, and Docker version
• Steps to reproduce the problem