Sourcebot is a self-hosted tool that helps you understand your codebase.
Find a file
2025-06-27 13:23:43 -07:00
.cursor/rules V4 (#311) 2025-05-28 16:08:42 -07:00
.github chore: remove staging & prod deploy actions 2025-06-02 10:33:58 -07:00
.vscode Display name improvements (#259) 2025-04-02 17:50:48 -07:00
.yarn/releases v3 effort (#158) 2025-03-31 22:34:42 -07:00
configs update example configs to use v3 schema 2025-04-01 10:26:46 -07:00
docs fix(docs): Fix nit issue in deployment docs 2025-06-27 13:23:43 -07:00
ee Search contexts (#273) 2025-04-24 22:28:13 -07:00
packages Correctly build URLs to file paths containing spaces (#364) 2025-06-24 11:57:55 -07:00
schemas V4 docs refactor (#322) 2025-06-01 18:51:12 -07:00
vendor feat: Generic git host support (local & remote) (#307) 2025-05-15 13:42:58 -07:00
.dockerignore v3 effort (#158) 2025-03-31 22:34:42 -07:00
.env.development Adds support for encrypted license keys (#335) 2025-06-05 22:18:52 -07:00
.gitignore v3 effort (#158) 2025-03-31 22:34:42 -07:00
.gitmodules update zoekt version 2025-04-01 10:38:50 -07:00
.yarnrc.yml v3 effort (#158) 2025-03-31 22:34:42 -07:00
CHANGELOG.md Correctly build URLs to file paths containing spaces (#364) 2025-06-24 11:57:55 -07:00
CONTRIBUTING.md fix ordering in contributing doc 2025-06-03 18:58:07 -07:00
default-config.json Config format V2 (#42) 2024-10-17 16:31:18 -04:00
demo-site-config.json enable public access on demo site 2025-05-28 17:07:53 -07:00
docker-compose-dev.yml [dev + copy button] add / update local dev w/docker compose; add copy button to the right of filenames (#328) 2025-06-03 08:52:59 -07:00
Dockerfile fix(search-contexts): Fix issue where a repository would not appear in a search context if it was created after the search context was created (#354) 2025-06-17 14:04:25 -07:00
entrypoint.sh Only create DB directory if using embedded DB (#267) 2025-04-10 21:39:31 -06:00
fly.toml Use main for demo site 2024-10-30 09:35:06 -07:00
grafana.alloy v3 effort (#158) 2025-03-31 22:34:42 -07:00
LICENSE fix(search-contexts): Fix issue where a repository would not appear in a search context if it was created after the search context was created (#354) 2025-06-17 14:04:25 -07:00
Makefile fix(search-contexts): Fix issue where a repository would not appear in a search context if it was created after the search context was created (#354) 2025-06-17 14:04:25 -07:00
package.json fix(search-contexts): Fix issue where a repository would not appear in a search context if it was created after the search context was created (#354) 2025-06-17 14:04:25 -07:00
prefix-output.sh Config format V2 (#42) 2024-10-17 16:31:18 -04:00
public.pem Adds support for encrypted license keys (#335) 2025-06-05 22:18:52 -07:00
README.md remove cloud reference in readme 2025-06-05 22:08:15 -07:00
supervisord.conf Review Agent (#298) 2025-05-12 12:10:01 -07:00
yarn.lock Adds code navigation and highlighting support for Tcl (#362) 2025-06-21 12:10:11 -07:00


Sourcebot uses Github Discussions for Support and Feature Requests.

About

Sourcebot is the open source Sourcegraph alternative. Index all your repos and branches across multiple code hosts (GitHub, GitLab, Bitbucket, Gitea, or Gerrit) and search through them using a blazingly fast interface.

https://github.com/user-attachments/assets/ced355f3-967e-4f37-ae6e-74ab8c06b9ec

Features

  • 💻 One-command deployment: Get started instantly using Docker on your own machine.
  • 🔍 Multi-repo search: Index and search through multiple public and private repositories and branches on GitHub, GitLab, Bitbucket, Gitea, or Gerrit.
  • Lightning fast performance: Built on top of the powerful Zoekt search engine.
  • 🎨 Modern web app: Enjoy a sleek interface with features like syntax highlighting, light/dark mode, and vim-style navigation
  • 📂 Full file visualization: Instantly view the entire file when selecting any search result.

You can try out our public hosted demo here!

Deploy Sourcebot

Sourcebot can be deployed in seconds using our official docker image. Visit our docs for more information.

  1. Create a config
touch config.json
echo '{
    "$schema": "https://raw.githubusercontent.com/sourcebot-dev/sourcebot/main/schemas/v3/index.json",
    "connections": {
        // Comments are supported
        "starter-connection": {
            "type": "github",
            "repos": [
                "sourcebot-dev/sourcebot"
            ]
        }
    }
}' > config.json
  1. Run the docker container
docker run \
  -p 3000:3000 \
  --pull=always \
  --rm \
  -v $(pwd):/data \
  -e CONFIG_PATH=/data/config.json \
  --name sourcebot \
  ghcr.io/sourcebot-dev/sourcebot:latest
What does this command do?
  • Pull and run the Sourcebot docker image from ghcr.io/sourcebot-dev/sourcebot:latest.
  • Mount the current directory (-v $(pwd):/data) to allow Sourcebot to persist the .sourcebot cache.
  • Clones sourcebot at HEAD into .sourcebot/github/sourcebot-dev/sourcebot.
  • Indexes sourcebot into a .zoekt index file in .sourcebot/index/.
  • Map port 3000 between your machine and the docker image.
  • Starts the web server on port 3000.

  1. Start searching at http://localhost:3000

To learn how to configure Sourcebot to index your own repos, please refer to our docs.

Note

Sourcebot collects anonymous usage data by default to help us improve the product. No sensitive data is collected, but if you'd like to disable this you can do so by setting the SOURCEBOT_TELEMETRY_DISABLED environment variable to true. Please refer to our telemetry docs for more information.

Build from source

Note

Building from source is only required if you'd like to contribute. If you'd just like to use Sourcebot, we recommend checking out our self-hosting docs.

If you'd like to build from source, please checkout the CONTRIBUTING.md file for more information.