Repolode
Submit
degoog-org

degoog-org/degoog

Self-hosted search aggregator that queries multiple engines and shows results in one page, extensible with plugins.

Open-source alternative to:Google Search

View on GitHubWebsite
Stars
2,518
Forks
109
Open issues
23
Last commit
8 days ago

What is it?

degoog is a self-hosted search aggregator. It sends a query to several search engines and combines the results in a single view, so you do not need to visit each engine separately.

The project is built around extensibility. You can add custom search engines, bang-command plugins that trigger from a query prefix, and slot plugins that render panels above or below the results or in the sidebar. Transports let you change how pages are fetched, for example through curl, FlareSolverr, or your own fetch logic.

It runs as a Docker or Podman container, natively with Bun, or via a NixOS module. Optional Valkey (Redis-compatible cache) and Postgres backends are provided through example Docker Compose files, and an MCP server option exposes it to LLM clients.

Key features

  • 01Aggregates results from multiple search engines into one page.
  • 02Supports custom search engines and bang-command plugins.
  • 03Slot plugins can add panels above, below, or beside results.
  • 04Transports allow custom HTTP fetch strategies such as curl or FlareSolverr.
  • 05Deployable via Docker, Podman, NixOS, or natively with Bun.

Use cases

  • Running a private, self-hosted search page that avoids sending queries to a single provider.
  • Combining results from several engines when one engine is blocked or incomplete.
  • Building custom search engines or query-triggered panels through plugins.
  • Exposing a search aggregator to LLM clients through the MCP option.

Quick start

  1. 1

    Create the data directory

    mkdir -p ./data
  2. 2

    Give the container user ownership of the data directory

    sudo chown -R 1000:1000 ./data
  3. 3

    Start degoog with Docker (set DEGOOG_SETTINGS_PASSWORDS before exposing it to the internet)

    docker run -d --name degoog -p 4444:4444 -v ./data:/app/data -e DEGOOG_SETTINGS_PASSWORDS=changeme --restart unless-stopped ghcr.io/degoog-org/degoog:latest

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires sharing modified source when the software is offered over a network.
  • An unlocked instance lets anyone install extensions, which run code on the server, so a password must be set before public exposure.
  • Community store extensions have only been initially vetted by the maintainer, so installing them is your own responsibility.

In collections

Self-hosted appsPrivacy & local-first tools

Topics

#search#meta-search#self-hosted#plugins#typescript#bun#privacy#aggregator#degoogle#degoogle-your-life

FAQ

What is degoog?
Self-hosted search aggregator that queries multiple engines and shows results in one page, extensible with plugins. degoog is a self-hosted search aggregator. It sends a query to several search engines and combines the results in a single view, so you do not need to visit each engine separately.
Is degoog free to use? What license does it have?
degoog is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is degoog still maintained?
Actively maintained. The last commit to degoog was on Oct 29, 2026.
What can I use degoog for?
Running a private, self-hosted search page that avoids sending queries to a single provider. Combining results from several engines when one engine is blocked or incomplete. Building custom search engines or query-triggered panels through plugins. Exposing a search aggregator to LLM clients through the MCP option.
How do I install degoog?
Create the data directory: mkdir -p ./data Give the container user ownership of the data directory: sudo chown -R 1000:1000 ./data Start degoog with Docker (set DEGOOG_SETTINGS_PASSWORDS before exposing it to the internet): docker run -d --name degoog -p 4444:4444 -v ./data:/app/data -e DEGOOG_SETTINGS_PASSWORDS=changeme --restart unless-stopped ghcr.io/degoog-org/degoog:latest
Where can I get degoog?
The source code and installation instructions are on GitHub: https://github.com/degoog-org/degoog

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects