This page lists common questions we hear from prospective customers who are considering Sourcegraph.

Most questions include an example answer and explanation. The explanation is formatted as normal text, and the example answer is formatted in a blockquote:

like this.

What is Sourcegraph?

See "What is Sourcegraph?".

What problems does Sourcegraph solve?

See "What problems does Sourcegraph solve?".

How is Sourcegraph different from the built-in code search of our code host?

This somewhat depends on which code host they're using. Look up the product comparison with their code host for details.

Generally, though, code hosts offer very basic code search functionality that isn't actually very useful for developers. If someone asks this question, they probably don't use code search very frequently, because if they did use their code host's code search, they would be familiar with its shortcomings. It is very, very rare that someone asking this question is an avid user of their code host's code search and wants to know the feature-by-feature comparison.

Here is a strategy for handling this question live (for simplicity, this assumes their code host is GitHub):

Well, first, how often do you use GitHub code search? [Their response is almost always "a few times a week" or less.] Makes total sense. The most helpful way to think about the difference is that with really good code search, you'd actually use code search many times per day. Sourcegraph becomes the first place you go to answer questions and unblock yourself while coding. I'll send you the public stats and docs (and the Yelp usage chart) about code search usage inside our customers and Google and Facebook, which all have really good code search. We usually see around 10–20% of developers inside an organization immediately becoming daily code search users, and over the next few weeks or months as other developers get accustomed to it, that number grows to 60-90% of all developers.

Should I deploy using Docker or to a cluster?

Start with the Docker quickstart (https://docs.sourcegraph.com/#quickstart) to try out Sourcegraph locally. When you're ready to deploy Sourcegraph for your organization, deploy using Docker (https://docs.sourcegraph.com/admin/install/docker) in most cases. The cluster deployment (https://docs.sourcegraph.com/admin/install/kubernetes) is easy to migrate to later for high scalability and high availability. Of course, if you just prefer deploying on Kubernetes, then starting with the cluster deployment is fine.

Does Sourcegraph respect GitHub (or other code host) permissions?

Yes, see repository permissions documentation (https://docs.sourcegraph.com/admin/permissions).

Why should I pay for Sourcegraph and not just use the open source version?

Here's a comprehensive answer that you can trim down based on the prospective customer's specific needs. It assumes that their developers are already using Sourcegraph internally because it's extremely rare that organizations begin by using the open source version (this question usually comes up at the end of a trial).