Troubleshooting Overview

Cockroach Labs will stop providing Assistance Support for this version on November 18, 2022. Prior to that date, upgrade to a more recent version to continue receiving support. For more details, see the Release Support Policy.

If you run into issues with CockroachDB, there are a few initial steps you can always take:

  1. Check your logs for errors related to your issue.

  2. Check our list of common errors for a solution. If you are getting transaction retry errors, see client-side retry handling and the Transaction Retry Error Reference.

  3. If the problem doesn't match a common error, try the following pages:

  4. If you cannot resolve the issue easily yourself, the following tools can help you get unstuck:

    • Support Resources identifies ways you can get help with troubleshooting.
    • File an Issue provides details about filing issues that you're unable to resolve.
YesYes NoNo