Reading the repo

Opening the box…

How to set up searxng (searxng/searxng) · gitmanual

Assembly instructions

searxng/searxng

SearXNG is a free internet metasearch engine which aggregates results from various search services and databases. Users are neither tracked nor profiled.

Node.jsPythonGo#bing#brave#degoogle#duckduckgo

Difficulty: Moderate
Time: about 15 min
Stars: ★ 39,215
Activity: Updated this month
License: AGPL-3.0
Open issues: 210
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 h ago

Start here

Website ↗docs.searxng.orgThe project's own site.In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Will it work on my device?

Yes, it runs on macOS

You'll build it yourself with Node.js, Python, Go.

Checking for

4 steps on macOS

Clone the repository

Needs Git: xcode-select --install

git clone https://github.com/searxng/searxng.git
cd searxng

2
Install the required runtimes
Node.js 25, Python 3.x (no version pinned), Go 1.24.5
```
brew install mise
mise install
```

Install dependencies

npm install
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -r requirements-dev.txt
go mod download

4
Run the tests
```
go test ./...
```

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

Claude reads the 18 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js 25runtime
1×Python 3.x (no version pinned)runtime
1×Go 1.24.5runtime
1×npm package manager
1×pip package manager

Share this manual

Good to know

Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Tool versions pinned in mise.toml — mise install (or asdf install) installs them all.
Nested projects: client/simple/package.json

package.json scripts (1)

cleanrm -Rf node_modules package-lock.json

Files we read (18)

.devcontainer/devcontainer.json

.github/workflows/ai-policy.yml

.github/workflows/container.yml

.github/workflows/data-update.yml

.github/workflows/documentation.yml

.github/workflows/integration.yml

.github/workflows/l10n.yml

.nvmrc

CONTRIBUTING.rst

Makefile

README.rst

container/.env.example

go.mod

mise.toml

package.json

requirements-dev.txt

requirements.txt

setup.py

Branch master · 1,010 files in the repo