SearXNG is a privacy-respecting metasearch engine that aggregates results from 70+ search engines — no tracking, no profiles. This add-on wraps the official searxng/searxng image with HA Ingress support and a custom.sh hook.

#Wiki Pages

Page	Purpose
Installation	Add repository, install, start.
Configuration	Add-on options and settings.yml.
JSON API	Use SearXNG from HA automations.
Troubleshooting	Ingress, blank page, search engines.

#Minimum Operating Model

HA Ingress → SearXNG Web UI :8080
SearXNG    → aggregates search engines (outbound)
Config     → addon_configs/<SLUG>_searxng/settings.yml

#Step 1 — Add Repository

1. Open Home Assistant.
2. Go to Settings → Add-ons → Add-on Store.
3. Open ⋮ → Repositories.
4. Add:

https://github.com/pol4rfuchs/ha-apps

#Step 2 — Install

1. Search for SearXNG in the Add-on Store.
2. Click Install.

#Step 3 — Start

1. Enable Start on boot.
2. Click Start.
3. Open via Open Web UI button or the HA sidebar.

#Add-on Options

Option	Default	Description
set_base_url_for_ingress	true	Auto-sets SEARXNG_BASE_URL to the HA Ingress URL. Disable only if using an external reverse proxy.

#settings.yml

After the first start, the settings file is written to:

addon_configs/<SLUG>_searxng/settings.yml

Edit it via the File Editor add-on. Changes apply after restarting the add-on.

Full reference: docs.searxng.org

#custom.sh Hook

Runs before SearXNG starts. Useful for patching settings or activating plugins:

addon_configs/<SLUG>_searxng/custom.sh

#!/bin/sh
# Example: force safe search
sed -i 's/safe_search: 0/safe_search: 1/' /etc/searxng/settings.yml

SearXNG exposes a JSON search API usable from HA automations and scripts.

#Endpoint

http://homeassistant.local:8080/search?q=your+query&format=json

#Home Assistant Integration

# configuration.yaml
rest_command:
  searxng_search:
    url: "http://localhost:8080/search?q={{ query }}&format=json"
    method: GET

#Limit to Specific Engines

http://localhost:8080/search?q=test&engines=google,bing&format=json

addon_configs/<SLUG>_searxng/
├── settings.yml    # SearXNG configuration
└── custom.sh       # Optional pre-start hook

The addon_configs directory is preserved across add-on updates. HA backups include it.

Symptom	Cause	Fix
Sidebar shows blank page	Ingress URL issue.	Use direct URL: http://HA-IP:8080
Settings not applied	Add-on not restarted.	Restart the add-on after editing settings.yml.
Search returns no results	Engine rate-limited or blocked.	Check engine list in settings.yml; some engines block automated queries.
Ingress URL wrong	Base URL not set.	Enable set_base_url_for_ingress: true.
custom.sh not running	Not executable.	Add chmod +x call or check script syntax.

Unofficial, community-maintained wrapper. SearXNG is licensed under AGPL-3.0. Add-on wrapper is MIT.