SearXNG

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

La configuration par défaut est suffisante pour une utilisation privé (non accessible depuis Internet) sauf cas particulier.

Pour une configuration publique :

...

Pour une version privée sans limitation (exemple : pour être utilisée par une IA) :

services:
  searxng:
    image: searxng/searxng:latest
    container_name: searxng
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./searxng-data:/etc/searxng
    environment:
      # Accès direct via IP :
      - SEARXNG_BASE_URL=http://IP_LXC:8080/
      # Accès via reverse proxy (HTTPS recommandé) :
      #- SEARXNG_BASE_URL=https://DNS_REVERSE_PROXY/

Pour une version publique derrière un reverse proxy :

services:
  searxng:
    image: searxng/searxng:latest
    container_name: searxng
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./searxng-data:/etc/searxng
    environment:
      # Accès direct via IP :
      #- SEARXNG_BASE_URL=http://IP_LXC:8080/
      # Accès via reverse proxy (HTTPS recommandé) :
      - SEARXNG_BASE_URL=https://DNS_REVERSE_PROXY/
      - SEARXNG_LIMITER=true
      - SEARXNG_PUBLIC_INSTANCE=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

Configuration

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

# vi /opt/searxng-docker/searxng-data/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