Prérequis

si Alpine LXC : avec Nesting et keyctl activé (Docker).
CPU :
- minimum : 1 vCPU
- recommandé : 2 vCPU (meilleure gestion des requêtes simultanées)
RAM :
- minimum : 512 Mo
- recommandé : 1 Go
- confortable : 2 Go si forte utilisation ou nombreux moteurs activés
Stockage :
- minimum : 1–2 Go
- recommandé : 5 Go (logs + cache)

Installation

On installe docker :

# apk update && apk upgrade
# apk add docker docker-cli-compose curl
# rc-update add docker default
# rc-service docker start

On installe SearXNG :

# mkdir -p /opt/searxng/core-config/
# cd /opt/searxng/
# curl -fsSL \
    -O https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
    -O https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example
# cp -i .env.example .env

On peux éditer le docker-compose :

# vi /opt/searxng/docker-compose.yml

La configuration par défaut est suffisante sauf cas particulier.

On édite le fichier de l'environnement :

# vi /opt/searxng/.env

Pour une utilisation privé (non accessible depuis Internet) :

...
SEARXNG_VALKEY_URL=valkey://valkey:6379/0

Pour une configuration publique (derrière un reverse-proxy) :

...
SEARXNG_VALKEY_URL=valkey://valkey:6379/0
SEARXNG_HOST=0.0.0.0
SEARXNG_PORT=8080
SEARXNG_BASE_URL=https://searxng.exemple.net/
SEARXNG_LIMITER=true
SEARXNG_PUBLIC_INSTANCE=true

Et pour la configuration publique uniquement on configure la détection de bots en créant le fichier limiter.toml :

# vi /opt/searxng/core-config/limiter.toml

[botdetection]
trusted_proxies = [
  'IP_REVERSEPROXY/32',
]

[botdetection.ip_limit]
filter_link_local = true
link_token = true

Pour un usage mixte (IA + accès public), il est recommandé de déployer deux instances distinctes de SearXNG.

On lance SearXNG :

# docker compose up -d

Vérification :

# docker ps

vhost reverse proxy nginx

Voir Reverse Proxy Nginx

server {
    listen 80;
    listen [::]:80;
    server_name searxng.exemple.net;
    return 301 https://$host$request_uri;
}

server {
    server_name searxng.exemple.net;

    # protection
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
    add_header Permissions-Policy "geolocation=(), microphone=(), camera=()" always;
    add_header Strict-Transport-Security "max-age=31536000" always;

    location / {
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Host  $host;
        proxy_set_header X-Forwarded-Port  $server_port;

        proxy_pass http://IP_SEARXNG:8080;
    }

    listen 443 ssl;
    listen [::]:443 ssl;
    ssl_certificate /etc/letsencrypt/live/searxng.exemple.net/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/searxng.exemple.net/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
}

Configuration

Pour configurer manuellement l'instance (après le premier démarrage), éditer le fichier :

# vi /opt/searxng/core-config/settings.yml

Appliquer les modifications :

# docker restart searxng

Les paramètres précédés ou suivis de "Is overwritten by ${EXEMPLE}" peuvent être surchargés par des variables d'environnement dans le docker-compose. Si celles-ci sont définies, elles prennent le dessus sur le fichier settings.yml.

Autoriser les requêtes via json pour les IA

# remove format to deny access, use lower case.
  # formats: [html, csv, json, rss]    
  formats:                                         
    - html                                            
    - json

# docker restart searxng