Installer son moteur de recherche privé SearXNG avec Docker en 2026

Étapes à suivre5

1. 1

   Installer Docker et préparer le serveur

   Installez Docker et Docker Compose sur votre serveur Ubuntu 22.04+. Commande: curl -fsSL https://get.docker.com | sh && sudo usermod -aG docker $USER. Déconnectez-vous puis reconnectez-vous pour que le groupe Docker soit pris en compte. Vérifiez avec docker --version (doit afficher Docker 24+). Installez aussi curl et openssl: sudo apt install -y curl openssl. Prérequis minimum: 2 Go RAM, 10 Go disque, Ubuntu 22.04 ou Debian 12. Si vous utilisez un VPS chez Hetzner, OVH ou Scaleway, le plus petit plan à 3,29 €/mois (1 vCPU, 2 Go RAM) suffit largement pour SearXNG. Vérifiez que les ports 80 et 443 sont ouverts dans le pare-feu du fournisseur. Sur Ubuntu, activez le pare-feu: sudo ufw allow 80/tcp && sudo ufw allow 443/tcp && sudo ufw allow 8888/tcp && sudo ufw enable. Vérifiez que Docker démarre au boot: sudo systemctl enable docker.
2. 2

   Télécharger et lancer SearXNG avec Docker Compose

   Créez le répertoire et téléchargez les fichiers officiels: mkdir -p ~/searxng/core-config && cd ~/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.env.example.env. Lancez SearXNG: docker compose up -d. Vérifiez que le conteneur tourne: docker compose ps doit afficher le conteneur searxng-core avec le statut Up. Ouvrez http://localhost:8888 dans votre navigateur — vous devez voir l’interface de recherche SearXNG. Si vous obtenez une erreur 502, attendez 10 secondes et rechargez: le conteneur met 5 à 8 secondes à démarrer complètement. Pour afficher les logs en cas de problème: docker compose logs -f core. Si le port 8888 est déjà utilisé, modifiez le port dans le fichier .env: SEARXNG_PORT=8889 puis relancez avec docker compose up -d.
3. 3

   Configurer settings.yml et sécuriser l'instance

   Le fichier de configuration se trouve dans ~/searxng/core-config/settings.yml. Étape obligatoire: remplacez la clé secrète par défaut. SECRET_KEY=$(openssl rand -hex 16) && sed -i "s/ultrasecretkey/$SECRET_KEY/" ~/searxng/core-config/settings.yml. Sans cette étape, SearXNG peut refuser de démarrer ou afficher un avertissement de sécurité. Personnalisez le nom de l’instance: sed -i 's/instance_name: "SearXNG"/instance_name: "Mon Moteur Privé"/' ~/searxng/core-config/settings.yml. Pour restreindre l’accès public, ajoutez dans la section server: limiter: true — cela active la limitation de taux (1 recherche par 2 secondes) pour empêcher les abus. Pour désactiver la recherche anonyme et exiger un mot de passe, ajoutez image_proxy: true dans la section server — cela empêche que les images soient chargées directement depuis les moteurs distants. Relancez après chaque modification: docker compose restart core. Vérifiez que les paramètres sont pris en compte: docker compose logs core | grep -i "server secret key".
4. 4

   Exposer SearXNG sur internet avec Caddy et HTTPS

   Installez Caddy comme reverse proxy: sudo apt install -y caddy. Créez la configuration: sudo tee /etc/caddy/Caddyfile << 'EOF' search.mondomaine.fr { reverse_proxy localhost:8888 encode gzip } EOF. Redémarrez Caddy: sudo systemctl restart caddy. Caddy obtient automatiquement un certificat Let's Encrypt — aucun certificat manuel à gérer. Vérifiez que votre DNS pointe vers le serveur: dig search.mondomaine.fr +short doit retourner l'IP de votre serveur. Résultat: votre moteur est accessible sur https://search.mondomaine.fr avec HTTPS. Si vous préférez Nginx, la configuration équivalente est disponible dans la documentation officielle SearXNG. Pour vérifier que HTTPS fonctionne: curl -I https://search.mondomaine.fr doit renvoyer HTTP/2 200. Si Caddy ne démarre pas, vérifiez les logs: sudo journalctl -u caddy --no-pager -n 50. Pour sécuriser davantage l'accès, ajoutez une authentification basique dans le Caddyfile: basicauth * { admin aénéré_Avec_caddy_hash_password }. Générez le hash avec caddy hash-password --plaintext 'votre_mot_de_passe'.
5. 5

   Mettre à jour et surveiller l'instance en production

   Mettre à jour SearXNG vers la dernière version: cd ~/searxng && docker compose down && docker compose pull && docker compose up -d. Vérifiez la version: docker compose exec core cat /usr/local/searxng/searxng-src/searx/version_frozen.py | grep VERSION_STRING. Pour automatiser les mises à jour hebdomadaires: echo '0 3 * * 0 cd /root/searxng && docker compose down && docker compose pull && docker compose up -d' | sudo tee /etc/cron.d/searxng-update. Surveillez les logs: docker compose logs -f core. Problème fréquent: les moteurs DuckDuckGo et Qwant bloquent par CAPTCHA (issue GitHub #4824). Solution: désactiver ces moteurs dans settings.yml et activer Startpage, Brave et Mojeek à la place. Pour vérifier quels moteurs répondent: sélectionnez le lien «! » en bas d'une page de résultats SearXNG.