Sourcegraph on Kubernetes

🚨 IMPORTANT: When upgrading Sourcegraph, please check upgrading docs to check if any manual migrations are necessary.

The master branch tracks development. Use the branch of this repository corresponding to the version of Sourcegraph you wish to deploy, e.g. git checkout 3.19.

Deploying Sourcegraph into a Kubernetes cluster is for organizations that need highly scalable and available code search and code intelligence. This repository contains documentation for creating, updating, and maintaining a Sourcegraph cluster.

For product and pricing information, visit about.sourcegraph.com or contact us for more information. If you're just starting out, we recommend running Sourcegraph as a single Docker container or using Docker Compose. Migrating to Sourcegraph on Kubernetes is easy later.

• Installing
• Configuring
• Updating
• Scaling- general advice on scaling services
• Resource estimator - specific resource values for your instance
• Troubleshooting
• Enterprise Getting Started Guide and Admin guide - useful guides for Sourcegraph admins
  • Metrics - guidance of metrics that can be used for monitoring Sourcegraph

Is Kubernetes the right deployment type for me?

Please see our docs for comparisons of deployment types and our resource estimator.

Contributing

We've made our deployment configurations open source to better serve our customers' needs. If there is anything we can do to make deploying Sourcegraph easier just open an issue (in sourcegraph/sourcegraph) or a pull request and we will respond promptly!

Questions & Issues

Open an issue (in sourcegraph/sourcegraph) or contact us ([email protected]), we are happy to help!

Licensing

The contents of this repository are open-source licensed. However, it makes reference to non-open-source images and actually running Sourcegraph using this repository falls under Sourcegraph's enterprise license terms.