[l10n] update translations from Weblate

6fd00e66a - 2025-12-18 - dtalens <dtalens@noreply.codeberg.org>
037518f3b - 2025-12-17 - dtalens <dtalens@noreply.codeberg.org>

.dir-locals-template.el

@@ -0,0 +1,163 @@
+;;; .dir-locals.el
+;;
+;; Per-Directory Local Variables:
+;;   https://www.gnu.org/software/emacs/manual/html_node/emacs/Directory-Variables.html
+;;
+;; For full fledge developer tools install emacs packages:
+;;
+;;    M-x package-install ...
+;;
+;;     magit gitconfig
+;;     nvm lsp-mode lsp-pyright lsp-eslint
+;;     pyvenv pylint pip-requirements
+;;     jinja2-mode
+;;     json-mode
+;;     company company-jedi company-quickhelp company-shell
+;;     realgud
+;;     sphinx-doc markdown-mode graphviz-dot-mode
+;;     apache-mode nginx-mode
+;;
+;; To setup a developer environment, build target::
+;;
+;;     $ make node.env.dev pyenv.install
+;;
+;; Some buffer locals are referencing the project environment:
+;;
+;; - prj-root                                --> <repo>/
+;; - nvm-dir                                 --> <repo>/.nvm
+;; - python-environment-directory            --> <repo>/local
+;; - python-environment-default-root-name    --> py3
+;; - python-shell-virtualenv-root            --> <repo>/local/py3
+;;       When this variable is set with the path of the virtualenv to use,
+;;      `process-environment' and `exec-path' get proper values in order to run
+;;      shells inside the specified virtualenv, example::
+;;         (setq python-shell-virtualenv-root "/path/to/env/")
+;; - python-shell-interpreter                --> <repo>/local/py3/bin/python
+;;
+;; Python development:
+;;
+;; Jedi, flycheck & other python stuff should use the 'python-shell-interpreter'
+;; from the local py3 environment.
+;;
+
+((nil
+  . ((fill-column . 80)
+     (indent-tabs-mode . nil)
+     (eval . (progn
+
+               (add-to-list 'auto-mode-alist '("\\.html\\'" . jinja2-mode))
+
+               ;; project root folder is where the `.dir-locals.el' is located
+               (setq-local prj-root
+                           (locate-dominating-file  default-directory ".dir-locals.el"))
+
+               (setq-local python-environment-directory
+                           (expand-file-name "./local" prj-root))
+
+               ;; to get in use of NVM environment, install https://github.com/rejeep/nvm.el
+               (setq-local nvm-dir (expand-file-name "./.nvm" prj-root))
+
+               ;; use nodejs from the (local) NVM environment (see nvm-dir)
+               (nvm-use-for-buffer)
+               (ignore-errors (require 'lsp))
+               (setq-local lsp-server-install-dir (car (cdr nvm-current-version)))
+               (setq-local lsp-enable-file-watchers nil)
+
+               ;; use 'py3' environment as default
+               (setq-local python-environment-default-root-name
+                           "py3")
+
+               (setq-local python-shell-virtualenv-root
+                           (expand-file-name
+                            python-environment-default-root-name python-environment-directory))
+
+               (setq-local python-shell-interpreter
+                           (expand-file-name
+                            "bin/python" python-shell-virtualenv-root))))))
+ (makefile-gmake-mode
+  . ((indent-tabs-mode . t)))
+
+ (yaml-mode
+  . ((eval . (progn
+
+               ;; flycheck should use the local py3 environment
+               (setq-local flycheck-yaml-yamllint-executable
+                           (expand-file-name "bin/yamllint" python-shell-virtualenv-root))
+
+               (setq-local flycheck-yamllintrc
+                           (expand-file-name  ".yamllint.yml" prj-root))
+
+               (flycheck-checker . yaml-yamllint)))))
+
+ (json-mode
+  . ((eval . (progn
+               (setq-local js-indent-level 4)
+               (flycheck-checker . json-python-json)))))
+
+ (js-mode
+  . ((eval . (progn
+               (ignore-errors (require 'lsp-eslint))
+               (setq-local js-indent-level 2)
+               ;; flycheck should use the eslint checker from developer tools
+               (setq-local flycheck-javascript-eslint-executable
+                           (expand-file-name "node_modules/.bin/eslint" prj-root))
+               ;; (flycheck-mode)
+
+               (if (featurep 'lsp-eslint)
+                   (lsp))
+               ))))
+
+ (python-mode
+  . ((eval . (progn
+               (ignore-errors (require 'jedi-core))
+               (ignore-errors (require 'lsp-pyright))
+               (ignore-errors (sphinx-doc-mode))
+               (setq-local python-environment-virtualenv
+                           (list (expand-file-name "bin/virtualenv" python-shell-virtualenv-root)
+                                 ;;"--system-site-packages"
+                                 "--quiet"))
+
+               (setq-local pylint-command
+                           (expand-file-name "bin/pylint" python-shell-virtualenv-root))
+
+               (if (featurep 'lsp-pyright)
+                   (lsp))
+
+               ;; pylint will find the '.pylintrc' file next to the CWD
+               ;;   https://pylint.readthedocs.io/en/latest/user_guide/run.html#command-line-options
+               (setq-local flycheck-pylintrc
+                           ".pylintrc")
+
+               ;; flycheck & other python stuff should use the local py3 environment
+               (setq-local flycheck-python-pylint-executable
+                           python-shell-interpreter)
+
+               ;; use 'M-x jedi:show-setup-info' and 'M-x epc:controller' to inspect jedi server
+               ;; https://tkf.github.io/emacs-jedi/latest/#jedi:environment-root -- You
+               ;; can specify a full path instead of a name (relative path). In that case,
+               ;; python-environment-directory is ignored and Python virtual environment
+               ;; is created at the specified path.
+               (setq-local jedi:environment-root
+                           python-shell-virtualenv-root)
+
+               ;; https://tkf.github.io/emacs-jedi/latest/#jedi:server-command
+               (setq-local jedi:server-command
+                           (list python-shell-interpreter
+                                 jedi:server-script))
+
+               ;; jedi:environment-virtualenv --> see above 'python-environment-virtualenv'
+               ;; is set buffer local!  No need to setup jedi:environment-virtualenv:
+               ;;
+               ;;    Virtualenv command to use.  A list of string.  If it is nil,
+               ;;    python-environment-virtualenv is used instead.  You must set non-nil
+               ;;    value to jedi:environment-root in order to make this setting work.
+               ;;
+               ;;    https://tkf.github.io/emacs-jedi/latest/#jedi:environment-virtualenv
+               ;;
+               ;; (setq-local jedi:environment-virtualenv
+               ;;             (list (expand-file-name "bin/virtualenv" python-shell-virtualenv-root)
+               ;;                   "--python"
+               ;;                   "/usr/bin/python3.4"
+               ;;                   ))
+               ))))
+ )

.dockerignore

@@ -1,6 +1,5 @@
 *
 
-!container/*.template.*
 !container/entrypoint.sh
 !searx/**
 !requirements*.txt

.github/ISSUE_TEMPLATE/bug-report.md

@@ -1,50 +1,39 @@
 ---
-name: "Bug report"
+name: Bug report
-about: Report a bug in SearXNG"
+about: Report a bug in SearXNG
-labels: ["bug"]
+title: ''
-type: "bug"
+labels: bug
+assignees: ''
+
 ---
+<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-_Replace this placeholder with a meaningful and precise description of the bug._
+**Version of SearXNG, commit number if you are using on master branch and stipulate if you forked SearXNG**
+<!-- If you are running on master branch using git execute this command
+in order to fetch the latest commit ID:
+```
+git log -1
+``` 
+If you are using searxng-docker then look at the bottom of the SearXNG page
+and check for the version after "Powered by SearXNG"
 
-<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
+Please also stipulate if you are using a forked version of SearXNG and
-
+include a link to the fork source code.
-     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
 -->
+**How did you install SearXNG?**
+<!-- Did you install SearXNG using the official wiki or using searxng-docker
+or manually by executing the searx/webapp.py file? -->
+**What happened?**
+<!-- A clear and concise description of what the bug is. -->
 
-### How To Reproduce?
+**How To Reproduce**
-
+<!-- How can we reproduce this issue? (as minimally and as precisely as possible) -->
-<!-- How can we reproduce this issue? (as minimally and as precisely as
-     possible) -->
-
-### Expected behavior
 
+**Expected behavior**
 <!-- A clear and concise description of what you expected to happen. -->
 
-### Screenshots & Logs
+**Screenshots & Logs**
-
 <!-- If applicable, add screenshots, logs to help explain your problem. -->
 
-### Version of SearXNG
+**Additional context**
-
-<!-- Commit number if you are using on master branch and stipulate if you forked
-     SearXNG -->
-
-<!-- Look at the bottom of the SearXNG page and check for the version after
-     "Powered by SearXNG" If you are using a forked version of SearXNG include a
-     link to the fork source code. -->
-
-### How did you install SearXNG?
-
-<!-- Did you install SearXNG using the official documentation or using
-     searxng-docker? -->
-
-### Additional context
-
 <!-- Add any other context about the problem here. -->
-
-### Code of Conduct
-
-[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
-
-- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
-blank_issues_enabled: false
+blank_issues_enabled: true
 contact_links:
   - name: Questions & Answers (Q&A)
     url: https://github.com/searxng/searxng/discussions/categories/q-a

.github/ISSUE_TEMPLATE/engine-request.md

@@ -1,46 +1,31 @@
 ---
-name: Engine request"
+name: Engine request
-about: Request a new engine in SearXNG"
+about: Request a new engine in SearXNG
-labels: ["engine request"]
+title: ''
-type: "feature"
+labels: enhancement, engine request
+assignees: ''
+
 ---
+<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
+**Working URL to the engine**
+<!-- Please check if the engine is responding correctly before submitting it. -->
 
-     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
+**Why do you want to add this engine?**
--->
+<!-- What's special about this engine? Is it open source or libre? -->
 
-### Working URL to the engine
+**Features of this engine**
+<!-- Features of this engine: Doesn't track its users, fast, easy to integrate, ... -->
 
-<!-- Please check if the engine is responding correctly before submitting -->
+**How can SearXNG fetch the information from this engine?**
+<!-- List API URL, example code (using the correct markdown) and more
+that could be useful for the developers in order to implement this engine.
+If you don't know what to write, let this part blank. -->
 
-### Why do you want to add this engine?
+**Applicable category of this engine**
+<!-- Where should this new engine fit in SearXNG? Current categories in SearXNG:
+general, files, images, it, map, music, news, science, social media and videos.
+You can add multiple categories at the same time. -->
 
-<!-- What's special about this engine?  -->
+**Additional context**
-
+<!-- Add any other context about this engine here. -->
-### Features of this engine
-
-<!-- Features of this engine: Serves special content, is fast, is easy to
-     integrate, ... ? -->
-
-### How can SearXNG fetch results from this engine?
-
-<!-- List API URL, example code and more that could be useful for the developers
-     in order to implement this engine.  If you don't know what to write, let
-     this part blank. -->
-
-### Applicable category of this engine
-
-<!-- Where should this new engine fit in SearXNG?  Current categories in
-     SearXNG: general, files, images, it, map, music, news, science, social
-     media and videos. -->
-
-### Additional context
-
-<!-- Add any other context about the problem here. -->
-
-### Code of Conduct
-
-[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
-
-- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/ISSUE_TEMPLATE/feature-request.md

@@ -1,32 +1,21 @@
 ---
-name: "Feature request"
+name: Feature request
-about: "Request a new feature in SearXNG"
+about: Request a new feature in SearXNG
-labels: ["new feature"]
+title: ''
-type: "feature"
+labels: enhancement
+assignees: ''
+
 ---
+<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-_Replace this placeholder with a concise description of the feature._
+**Is your feature request related to a problem? Please describe.**
-
+<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] -->
-<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
-
-     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
--->
-
-### Is your feature request related to a problem?
-
-<!-- A clear and concise description of what the problem is. Ex. I'm always
-     frustrated when [...] -->
-
-### Describe the solution you'd like
 
+**Describe the solution you'd like**
 <!-- A clear and concise description of what you want to happen. -->
 
-### Describe alternatives you've considered
+**Describe alternatives you've considered**
-
 <!-- A clear and concise description of any alternative solutions or features you've considered. -->
 
-### Code of Conduct
+**Additional context**
-
+<!-- Add any other context or screenshots about the feature request here. -->
-[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
-
-- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/workflows/checker.yml

@@ -0,0 +1,47 @@
+---
+name: Checker
+
+# yamllint disable-line rule:truthy
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "0 4 * * 5"
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.14"
+
+jobs:
+  search:
+    if: github.repository_owner == 'searxng' || github.event_name == 'workflow_dispatch'
+    name: Search
+    runs-on: ubuntu-24.04-arm
+    steps:
+      - name: Setup Python
+        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
+        with:
+          python-version: "${{ env.PYTHON_VERSION }}"
+
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
+        with:
+          persist-credentials: "false"
+
+      - name: Setup cache Python
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
+        with:
+          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
+          path: "./local"
+
+      - name: Setup venv
+        run: make V=1 install
+
+      - name: Search checker
+        run: make search.checker

.github/workflows/container.yml

@@ -25,21 +25,25 @@ env:
 
 jobs:
   build:
-    if: |
+    if: github.repository_owner == 'searxng' || github.event_name == 'workflow_dispatch'
-      github.event_name == 'workflow_dispatch'
-      || (github.repository_owner == 'searxng' && github.event.workflow_run.conclusion == 'success')
     name: Build (${{ matrix.arch }})
-    runs-on: ${{ matrix.runner }}
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
         include:
-          - runner: ubuntu-26.04
+          - arch: amd64
-            arch: amd64
+            march: amd64
-          - runner: ubuntu-26.04-arm
+            os: ubuntu-24.04
-            arch: arm64
+            emulation: false
-          - runner: ubuntu-26.04-arm
+          - arch: arm64
-            arch: armv7
+            march: arm64
+            os: ubuntu-24.04-arm
+            emulation: false
+          - arch: armv7
+            march: arm64
+            os: ubuntu-24.04-arm
+            emulation: true
 
     permissions:
       packages: write
@@ -49,82 +53,113 @@ jobs:
       git_url: ${{ steps.build.outputs.git_url }}
 
     steps:
-      - name: Login to GHCR
+      # yamllint disable rule:line-length
-        uses: docker/login-action@06fb636fac595d6fb4b28a5dfcb21a6f5091859c  # v4.5.0
+      - name: Setup podman
-        with:
+        env:
-          registry: "ghcr.io"
+          PODMAN_VERSION: "v5.6.2"
-          username: "${{ github.repository_owner }}"
+        run: |
-          password: "${{ secrets.GITHUB_TOKEN }}"
+          # dpkg man-db trigger is very slow on GHA runners
+          # https://github.com/actions/runner-images/issues/10977
+          # https://github.com/actions/runner/issues/4030
+          sudo rm -f /var/lib/man-db/auto-update
+
+          sudo apt-get purge -y podman runc crun conmon
+
+          curl -fsSLO "https://github.com/mgoltzsche/podman-static/releases/download/${{ env.PODMAN_VERSION }}/podman-linux-${{ matrix.march }}.tar.gz"
+          curl -fsSLO "https://github.com/mgoltzsche/podman-static/releases/download/${{ env.PODMAN_VERSION }}/podman-linux-${{ matrix.march }}.tar.gz.asc"
+          gpg --keyserver hkps://keyserver.ubuntu.com --recv-keys 0CCF102C4F95D89E583FF1D4F8B5AF50344BB503
+          gpg --batch --verify "podman-linux-${{ matrix.march }}.tar.gz.asc" "podman-linux-${{ matrix.march }}.tar.gz"
+
+          tar -xzf "podman-linux-${{ matrix.march }}.tar.gz"
+          sudo cp -rfv ./podman-linux-${{ matrix.march }}/etc/. /etc/
+          sudo cp -rfv ./podman-linux-${{ matrix.march }}/usr/. /usr/
+
+          sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
+      # yamllint enable rule:line-length
 
       - name: Setup Python
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
-      - name: Setup QEMU
-        uses: docker/setup-qemu-action@96fe6ef7f33517b61c61be40b68a1882f3264fb8  # v4.2.0
-
       - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
         with:
-          ref: "${{ github.event.workflow_run.head_sha || github.sha }}"
           persist-credentials: "false"
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: |
+          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
-            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
+      - name: Get date
+        id: date
+        run: echo "date=$(date +'%Y%m%d')" >>$GITHUB_OUTPUT
+
       - name: Setup cache container
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
         with:
-          key: "container-${{ matrix.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          key: "container-${{ matrix.arch }}-${{ steps.date.outputs.date }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: |
-            container-${{ matrix.arch }}-
+            "container-${{ matrix.arch }}-${{ steps.date.outputs.date }}-"
+            "container-${{ matrix.arch }}-"
           path: "/var/tmp/buildah-cache-*/*"
 
+      - if: ${{ matrix.emulation }}
+        name: Setup QEMU
+        uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130  # v3.7.0
+
+      - name: Login to GHCR
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef  # v3.6.0
+        with:
+          registry: "ghcr.io"
+          username: "${{ github.repository_owner }}"
+          password: "${{ secrets.GITHUB_TOKEN }}"
+
       - name: Build
         id: build
         env:
           OVERRIDE_ARCH: "${{ matrix.arch }}"
-        run: make container.build
+        run: make podman.build
 
   test:
     name: Test (${{ matrix.arch }})
-    runs-on: ${{ matrix.runner }}
+    runs-on: ${{ matrix.os }}
     needs: build
     strategy:
       fail-fast: false
       matrix:
         include:
-          - runner: ubuntu-26.04
+          - arch: amd64
-            arch: amd64
+            os: ubuntu-24.04
-          - runner: ubuntu-26.04-arm
+            emulation: false
-            arch: arm64
+          - arch: arm64
-          - runner: ubuntu-26.04-arm
+            os: ubuntu-24.04-arm
-            arch: armv7
+            emulation: false
+          - arch: armv7
+            os: ubuntu-24.04-arm
+            emulation: true
 
     steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
+        with:
+          persist-credentials: "false"
+
+      - if: ${{ matrix.emulation }}
+        name: Setup QEMU
+        uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130  # v3.7.0
+
       - name: Login to GHCR
-        uses: docker/login-action@06fb636fac595d6fb4b28a5dfcb21a6f5091859c  # v4.5.0
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef  # v3.6.0
         with:
           registry: "ghcr.io"
           username: "${{ github.repository_owner }}"
           password: "${{ secrets.GITHUB_TOKEN }}"
 
-      - name: Setup QEMU
-        uses: docker/setup-qemu-action@96fe6ef7f33517b61c61be40b68a1882f3264fb8  # v4.2.0
-
-      - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
-        with:
-          ref: "${{ github.event.workflow_run.head_sha || github.sha }}"
-          persist-credentials: "false"
-
       - name: Test
         env:
           OVERRIDE_ARCH: "${{ matrix.arch }}"
@@ -134,7 +169,7 @@ jobs:
   release:
     if: github.repository_owner == 'searxng' && github.ref_name == 'master'
     name: Release
-    runs-on: ubuntu-26.04-arm
+    runs-on: ubuntu-24.04-arm
     needs:
       - build
       - test
@@ -143,25 +178,24 @@ jobs:
       packages: write
 
     steps:
-      - name: Login to Docker Hub
+      - name: Checkout
-        uses: docker/login-action@06fb636fac595d6fb4b28a5dfcb21a6f5091859c  # v4.5.0
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
         with:
-          registry: "docker.io"
+          persist-credentials: "false"
-          username: "${{ secrets.DOCKER_USER }}"
-          password: "${{ secrets.DOCKER_TOKEN }}"
 
       - name: Login to GHCR
-        uses: docker/login-action@06fb636fac595d6fb4b28a5dfcb21a6f5091859c  # v4.5.0
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef  # v3.6.0
         with:
           registry: "ghcr.io"
           username: "${{ github.repository_owner }}"
           password: "${{ secrets.GITHUB_TOKEN }}"
 
-      - name: Checkout
+      - name: Login to Docker Hub
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef  # v3.6.0
         with:
-          ref: "${{ github.event.workflow_run.head_sha || github.sha }}"
+          registry: "docker.io"
-          persist-credentials: "false"
+          username: "${{ secrets.DOCKER_USER }}"
+          password: "${{ secrets.DOCKER_TOKEN }}"
 
       - name: Release
         env:

.github/workflows/data-update.yml

@@ -21,7 +21,7 @@ jobs:
   data:
     if: github.repository_owner == 'searxng'
     name: ${{ matrix.fetch }}
-    runs-on: ubuntu-26.04-arm
+    runs-on: ubuntu-24.04-arm
     strategy:
       fail-fast: false
       matrix:
@@ -40,21 +40,20 @@ jobs:
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
         with:
           persist-credentials: "false"
 
       - name: Setup cache Python
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: |
+          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
-            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -64,17 +63,23 @@ jobs:
         run: V=1 ./manage pyenv.cmd python "./searxng_extra/update/${{ matrix.fetch }}"
 
       - name: Create PR
-        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1  # v8.1.1
+        id: cpr
+        uses: peter-evans/create-pull-request@98357b18bf14b5342f975ff684046ec3b2a07725  # v8.0.0
         with:
           author: "searxng-bot <searxng-bot@users.noreply.github.com>"
           committer: "searxng-bot <searxng-bot@users.noreply.github.com>"
-          title: "[mod] data: update searx.data - ${{ matrix.fetch }}"
+          title: "[data] update searx.data - ${{ matrix.fetch }}"
-          commit-message: "[mod] data: update searx.data - ${{ matrix.fetch }}"
+          commit-message: "[data] update searx.data - ${{ matrix.fetch }}"
-          branch: "ci-data-${{ matrix.fetch }}"
+          branch: "update_data_${{ matrix.fetch }}"
           delete-branch: "true"
           draft: "false"
           signoff: "false"
           body: |
-            Update searx.data - ${{ matrix.fetch }}
+            [data] update searx.data - ${{ matrix.fetch }}
           labels: |
             data
+
+      - name: Display information
+        run: |
+          echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
+          echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"

.github/workflows/documentation.yml

@@ -25,47 +25,43 @@ jobs:
   release:
     if: github.repository_owner == 'searxng' || github.event_name == 'workflow_dispatch'
     name: Release
-    runs-on: ubuntu-26.04-arm
+    runs-on: ubuntu-24.04-arm
     permissions:
       # for JamesIves/github-pages-deploy-action to push
       contents: write
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
         with:
           persist-credentials: "false"
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: |
+          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
-            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
-      - name: Setup dependencies
-        run: sudo ./utils/searxng.sh install buildhost
-
       - name: Setup venv
         run: make V=1 install
 
       - name: Build documentation
-        run: make V=1 docs.html
+        run: make V=1 docs.clean docs.html
 
       - if: github.ref_name == 'master'
         name: Release
-        uses: JamesIves/github-pages-deploy-action@d92aa235d04922e8f08b40ce78cc5442fcfbfa2f  # v4.8.0
+        uses: JamesIves/github-pages-deploy-action@9d877eea73427180ae43cf98e8914934fe157a1a  # v4.7.6
         with:
           folder: "dist/docs"
           branch: "gh-pages"
-          commit-message: "[mod] docs: build from commit ${{ github.sha }}"
+          commit-message: "[doc] build from commit ${{ github.sha }}"
           # Automatically remove deleted files from the deploy branch
           clean: "true"
           single-commit: "true"

.github/workflows/integration.yml

@@ -23,10 +23,11 @@ env:
 jobs:
   test:
     name: Python ${{ matrix.python-version }}
-    runs-on: ubuntu-26.04
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
         python-version:
+          - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
@@ -34,21 +35,20 @@ jobs:
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
         with:
           python-version: "${{ matrix.python-version }}"
 
       - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
         with:
           persist-credentials: "false"
 
       - name: Setup cache Python
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
         with:
           key: "python-${{ matrix.python-version }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: |
+          restore-keys: "python-${{ matrix.python-version }}-${{ runner.arch }}-"
-            python-${{ matrix.python-version }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -59,40 +59,36 @@ jobs:
 
   theme:
     name: Theme
-    runs-on: ubuntu-26.04-arm
+    runs-on: ubuntu-24.04-arm
     steps:
       - name: Setup Python
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
-      - name: Setup Node.js
-        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020  # v7.0.0
-        with:
-          node-version: "26"
-          check-latest: "true"
-
       - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
         with:
           persist-credentials: "false"
 
-      - name: Setup cache Python
+      - name: Setup Node.js
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f  # v6.1.0
         with:
-          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          node-version-file: "./.nvmrc"
-          restore-keys: |
-            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
-          path: "./local/"
 
       - name: Setup cache Node.js
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
         with:
-          key: "nodejs-${{ runner.arch }}-${{ hashFiles('**/package-lock.json') }}"
+          key: "nodejs-${{ runner.arch }}-${{ hashFiles('./.nvmrc', './package.json') }}"
-          restore-keys: |
-            nodejs-${{ runner.arch }}-
           path: "./client/simple/node_modules/"
 
+      - name: Setup cache Python
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
+        with:
+          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
+          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
+          path: "./local/"
+
       - name: Setup venv
         run: make V=1 install
 

.github/workflows/l10n.yml

@@ -26,31 +26,30 @@ env:
 
 jobs:
   update:
-    if: github.event.workflow_run.conclusion == 'success' && github.repository_owner == 'searxng'
+    if: github.repository_owner == 'searxng' && github.event.workflow_run.conclusion == 'success'
     name: Update
-    runs-on: ubuntu-26.04-arm
+    runs-on: ubuntu-24.04-arm
     permissions:
       # For "make V=1 weblate.push.translations"
       contents: write
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
         with:
           token: "${{ secrets.WEBLATE_GITHUB_TOKEN }}"
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: |
+          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
-            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -59,7 +58,7 @@ jobs:
       - name: Setup Weblate
         run: |
           mkdir -p ~/.config
-          echo "${{ secrets.WEBLATE_CONFIG }}" >~/.config/weblate
+          echo "${{ secrets.WEBLATE_CONFIG }}" > ~/.config/weblate
 
       - name: Setup Git
         run: |
@@ -74,7 +73,7 @@ jobs:
       github.repository_owner == 'searxng'
       && (github.event_name == 'workflow_dispatch' || github.event_name == 'schedule')
     name: Pull Request
-    runs-on: ubuntu-26.04-arm
+    runs-on: ubuntu-24.04-arm
     permissions:
       # For "make V=1 weblate.translations.commit"
       contents: write
@@ -83,22 +82,21 @@ jobs:
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        uses: actions/setup-python@83679a892e2d95755f2dac6acb0bfd1e9ac5d548  # v6.1.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
         with:
           token: "${{ secrets.WEBLATE_GITHUB_TOKEN }}"
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v6.1.0
+        uses: actions/cache@a7833574556fa59680c1b7cb190c1735db73ebf0  # v5.0.0
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: |
+          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
-            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -107,7 +105,7 @@ jobs:
       - name: Setup Weblate
         run: |
           mkdir -p ~/.config
-          echo "${{ secrets.WEBLATE_CONFIG }}" >~/.config/weblate
+          echo "${{ secrets.WEBLATE_CONFIG }}" > ~/.config/weblate
 
       - name: Setup Git
         run: |
@@ -118,17 +116,23 @@ jobs:
         run: make V=1 weblate.translations.commit
 
       - name: Create PR
-        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1  # v8.1.1
+        id: cpr
+        uses: peter-evans/create-pull-request@98357b18bf14b5342f975ff684046ec3b2a07725  # v8.0.0
         with:
           author: "searxng-bot <searxng-bot@users.noreply.github.com>"
           committer: "searxng-bot <searxng-bot@users.noreply.github.com>"
-          title: "[mod] i18n: update translations from Weblate"
+          title: "[l10n] update translations from Weblate"
-          commit-message: "[mod] i18n: update translations from Weblate"
+          commit-message: "[l10n] update translations from Weblate"
           branch: "translations_update"
           delete-branch: "true"
           draft: "false"
           signoff: "false"
           body: |
-            Update translations from Weblate
+            [l10n] update translations from Weblate
           labels: |
-            area:i18n
+            translation
+
+      - name: Display information
+        run: |
+          echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
+          echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"

.github/workflows/security.yml

@@ -0,0 +1,46 @@
+---
+name: Security
+
+# yamllint disable-line rule:truthy
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "42 05 * * *"
+
+concurrency:
+  group: ${{ github.workflow }}
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+
+jobs:
+  container:
+    if: github.repository_owner == 'searxng'
+    name: Container
+    runs-on: ubuntu-24.04-arm
+    permissions:
+      security-events: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
+        with:
+          persist-credentials: "false"
+
+      - name: Sync GHCS from Docker Scout
+        uses: docker/scout-action@f8c776824083494ab0d56b8105ba2ca85c86e4de  # v1.18.2
+        with:
+          organization: "searxng"
+          dockerhub-user: "${{ secrets.DOCKER_USER }}"
+          dockerhub-password: "${{ secrets.DOCKER_TOKEN }}"
+          image: "registry://ghcr.io/searxng/searxng:latest"
+          command: "cves"
+          sarif-file: "./scout.sarif"
+          exit-code: "false"
+          write-comment: "false"
+
+      - name: Upload SARIFs
+        uses: github/codeql-action/upload-sarif@cf1bb45a277cb3c205638b2cd5c984db1c46a412  # v4.31.7
+        with:
+          sarif_file: "./scout.sarif"

.helix/languages.toml

@@ -1,11 +0,0 @@
-[[language]]
-name = "python"
-language-servers = ["basedpyright", "pylsp"]
-auto-format = true
-
-[language-server.pylsp.config.pylsp]
-plugins.pylint.enabled = true
-plugins.isort.enabled = true
-plugins.black.enabled = true
-plugins.black.skip_string_normalization = true
-plugins.black.line_length = 120

AI_POLICY.rst

@@ -1,20 +0,0 @@
-.. SPDX-License-Identifier: AGPL-3.0-or-later
-
-AI Policy
-=========
-
-Restrictions on Generative AI Usage
------------------------------------
-- **All AI usage in any form must be disclosed.** You must state the tool you used (e.g. Claude Code, Cursor, Amp) along with the extent that the work was AI-assisted.
-- **The human-in-the-loop must fully understand all code.** If you use generative AI tools as an aid in developing code or documentation changes, ensure that you fully understand the proposed changes and can explain why they are the correct approach.
-- **AI should never be the main author of the PR.** AI may be used as a tool to help with developing, but the human contribution to the code changes should always be reasonably larger than the part written by AI. For example, you should be the one that decides about the structure of the PR, not the LLM.
-- **Issues and PR descriptions must be fully human-written.** Do not post output from Large Language Models or similar generative AI as comments on any of our discussion forums (e.g. GitHub Issues, Matrix, ...), as such comments tend to be formulaic and low content. If you're a not a native English speaker, using AI for translating self-written issue texts to English is okay, but please keep the wording as close as possible to the original wording.
-- **Bad AI drivers will be denounced.** People who produce bad contributions that are clearly AI (slop) will be blocked for all future contributions.
-
-There are Humans Here
----------------------
-Every discussion, issue, and pull request is read and reviewed by humans. It is a boundary point at which people interact with each other and the work done. It is rude and disrespectful to approach this boundary with low-effort, unqualified work, since it puts the burden of validation on the maintainer.
-
-It takes a lot of maintainer time and energy to review AI-generated contributions! Sending the output of an LLM to open source project maintainers extracts work from them in the form of design and code review, so we call this kind of contribution an "extractive contribution".
-
-The *golden rule* is that a contribution should be worth more to the project than the time it takes to review it, which is usually not the case if large parts of your PR were written by LLMs.

CONTRIBUTING.rst

@@ -2,7 +2,6 @@
 
 .. _Quickstart guide: https://docs.searxng.org/dev/quickstart.html
 .. _Commits guide: https://docs.searxng.org/dev/commits.html
-.. _AI Policy: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
 .. _Weblate: https://translate.codeberg.org/projects/searxng/searxng/
 .. _GitHub Codespaces: https://docs.github.com/en/codespaces/overview
 .. _120 hours per month: https://github.com/settings/billing
@@ -91,8 +90,3 @@ rules in this project are:
 - Prefer fewer arguments.
 - Do not add obvious comments to code.
 - Do not comment out code, delete lines instead.
-
-AI Policy
-~~~~~~~~~
-
-For our policy on the use of AI tools, please read `AI Policy`_.

Makefile

@@ -17,6 +17,7 @@ help:
 	@echo 'install        - developer install of SearxNG into virtualenv'
 	@echo 'uninstall      - uninstall developer installation'
 	@echo 'clean          - clean up working tree'
+	@echo 'search.checker - check search engines'
 	@echo 'test           - run shell & CI tests'
 	@echo 'test.shell     - test shell scripts'
 	@echo 'ci.test        - run CI tests'
@@ -38,6 +39,12 @@ clean: py.clean docs.clean node.clean nvm.clean go.clean test.clean
 	$(Q)find . -name '*~' -exec rm -f {} +
 	$(Q)find . -name '*.bak' -exec rm -f {} +
 
+PHONY += search.checker search.checker.%
+search.checker: install
+	$(Q)./manage pyenv.cmd searxng-checker -v
+
+search.checker.%: install
+	$(Q)./manage pyenv.cmd searxng-checker -v "$(subst _, ,$(patsubst search.checker.%,%,$@))"
 
 PHONY += test ci.test test.shell
 test:    test.yamllint test.black test.pyright_modified test.pylint test.unit test.robot test.rst test.shell test.shfmt

PULL_REQUEST_TEMPLATE.md

@@ -1,34 +1,25 @@
-<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
+## What does this PR do?
 
-     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
+<!-- MANDATORY -->
--->
 
-### What does this PR do?
+<!-- explain the changes in your PR, algorithms, design, architecture -->
 
-<!-- Explain the motivation and changes in your pull request.  -->
+## Why is this change important?
 
-### How to test this PR locally?
+<!-- MANDATORY -->
 
-<!-- Commands to run the tests or instructions to test the changes.  Are there
+<!-- explain the motivation behind your PR -->
-     any edge cases (environment, language, or other contexts) to take into
-     account?  -->
 
-### Related issues
+## How to test this PR locally?
+
+<!-- commands to run the tests or instructions to test the changes -->
+
+## Author's checklist
+
+<!-- additional notes for reviewers -->
+
+## Related issues
 
 <!--
-Closes: #234
+Closes #234
 -->
-
-### Code of Conduct
-
-<!-- ⚠️ Bad AI drivers will be denounced: People who produce bad contributions
-     that are clearly AI (slop) will be blocked for all future contributions.
-     -->
-
-[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
-
-- [ ] **I hereby confirm that this PR conforms with the [AI Policy].**
-
-  If I have used AI tools for working on the changes in this PR, I will
-  attach a list of all AI tools I used and how I used them. I hereby confirm
-  that I haven't used any other tools than the ones I mention below.

README.rst

@@ -46,9 +46,11 @@ Further information on *how-to* can be found `here <https://docs.searxng.org/adm
 Connect
 =======
 
-If you have questions or want to connect with others in the community:
+If you have questions or want to connect with others in the community,
+we have two official channels:
 
 - `#searxng:matrix.org <https://matrix.to/#/#searxng:matrix.org>`_
+- `#searxng @ libera.chat <https://web.libera.chat/?channel=#searxng>`_ (bridged to Matrix)
 
 Contributing
 ============

client/simple/.stylelintrc.json

@@ -4,9 +4,7 @@
   "extends": ["stylelint-config-standard-less"],
   "rules": {
     "at-rule-no-vendor-prefix": null,
-    "at-rule-prelude-no-invalid": null,
     "declaration-empty-line-before": null,
-    "declaration-property-value-no-unknown": null,
     "no-invalid-position-at-import-rule": null,
     "prettier/prettier": true,
     "property-no-vendor-prefix": null,

client/simple/biome.json

@@ -1,13 +1,13 @@
 {
-  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
   "files": {
     "ignoreUnknown": true,
-    "includes": ["**", "!node_modules", "!src/brand", "!src/svg"]
+    "includes": ["**", "!node_modules"]
   },
   "assist": {
     "enabled": true,
     "actions": {
-      "preset": "recommended",
+      "recommended": true,
       "source": {
         "useSortedAttributes": "on",
         "useSortedProperties": "on"
@@ -27,14 +27,10 @@
   "linter": {
     "enabled": true,
     "rules": {
-      "preset": "recommended",
+      "recommended": true,
       "complexity": {
         "noForEach": "error",
         "noImplicitCoercions": "error",
-        "noRedundantDefaultExport": "error",
-        "noUselessCatchBinding": "error",
-        "noUselessUndefined": "error",
-        "useArrayFind": "error",
         "useSimplifiedLogicExpression": "error"
       },
       "correctness": {
@@ -44,12 +40,21 @@
         "useSingleJsDocAsterisk": "error"
       },
       "nursery": {
+        "noContinue": "warn",
+        "noDeprecatedImports": "warn",
+        "noEqualsToNull": "warn",
         "noFloatingPromises": "warn",
+        "noForIn": "warn",
+        "noImportCycles": "warn",
+        "noIncrementDecrement": "warn",
         "noMisusedPromises": "warn",
-        "useAwaitThenable": "off",
+        "noMultiStr": "warn",
+        "noParametersOnlyUsedInRecursion": "warn",
+        "noUselessCatchBinding": "warn",
+        "noUselessUndefined": "warn",
         "useExhaustiveSwitchCases": "warn",
-        "useExplicitType": "off",
+        "useExplicitType": "warn",
-        "useRegexpExec": "warn"
+        "useFind": "warn"
       },
       "performance": {
         "noAwaitInLoops": "error",
@@ -63,15 +68,23 @@
         "noCommonJs": "error",
         "noEnum": "error",
         "noImplicitBoolean": "error",
-        "noIncrementDecrement": "error",
         "noInferrableTypes": "error",
-        "noMultiAssign": "error",
-        "noMultilineString": "error",
         "noNamespace": "error",
         "noNegationElse": "error",
         "noNestedTernary": "error",
         "noParameterAssign": "error",
         "noParameterProperties": "error",
+        "noRestrictedTypes": {
+          "level": "error",
+          "options": {
+            "types": {
+              "Element": {
+                "message": "Element is too generic",
+                "use": "HTMLElement"
+              }
+            }
+          }
+        },
         "noSubstr": "error",
         "noUnusedTemplateLiteral": "error",
         "noUselessElse": "error",
@@ -87,7 +100,6 @@
           }
         },
         "useConsistentBuiltinInstantiation": "error",
-        "useConsistentEnumValueType": "error",
         "useConsistentMemberAccessibility": {
           "level": "error",
           "options": {
@@ -107,7 +119,6 @@
           }
         },
         "useDefaultSwitchClause": "error",
-        "useDestructuring": "error",
         "useExplicitLengthCheck": "error",
         "useForOf": "error",
         "useGroupedAccessorPairs": "error",
@@ -124,17 +135,11 @@
         "useUnifiedTypeSignatures": "error"
       },
       "suspicious": {
+        "noAlert": "error",
         "noBitwiseOperators": "error",
         "noConstantBinaryExpressions": "error",
-        "noDeprecatedImports": "error",
         "noEmptyBlockStatements": "error",
-        "noEqualsToNull": "error",
         "noEvolvingTypes": "error",
-        "noForIn": "error",
-        "noImportCycles": "error",
-        "noNestedPromises": "error",
-        "noParametersOnlyUsedInRecursion": "error",
-        "noReturnAssign": "error",
         "noUnassignedVariables": "error",
         "noVar": "error",
         "useNumberToFixedDigitsArgument": "error",

client/simple/generated/pygments.less

@@ -2,7 +2,7 @@
 
 /*
    this file is generated automatically by searxng_extra/update/update_pygments.py
-   using pygments version 2.20.0:
+   using pygments version 2.19.2:
 
        ./manage templates.simple.pygments
 */

client/simple/package.json

@@ -23,27 +23,27 @@
     "not dead"
   ],
   "dependencies": {
-    "ionicons": "^8.0.13",
+    "ionicons": "~8.0.13",
     "normalize.css": "8.0.1",
-    "ol": "^10.9.0",
+    "ol": "~10.7.0",
     "swiped-events": "1.2.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.5",
+    "@biomejs/biome": "2.3.8",
-    "@types/node": "^26.1.1",
+    "@types/node": "~25.0.1",
-    "browserslist": "^4.28.7",
+    "browserslist": "~4.28.1",
-    "browserslist-to-esbuild": "^2.1.1",
+    "browserslist-to-esbuild": "~2.1.1",
-    "edge.js": "^6.5.1",
+    "edge.js": "~6.3.0",
-    "less": "^4.8.0",
+    "less": "~4.4.2",
-    "mathjs": "^15.2.0",
+    "mathjs": "~15.1.0",
-    "sharp": "~0.35.3",
+    "sharp": "~0.34.5",
-    "sort-package-json": "^4.0.0",
+    "sort-package-json": "~3.5.1",
-    "stylelint": "^17.14.1",
+    "stylelint": "~16.26.0",
-    "stylelint-config-standard-less": "^4.1.0",
+    "stylelint-config-standard-less": "~3.0.1",
-    "stylelint-prettier": "^5.0.3",
+    "stylelint-prettier": "~5.0.3",
-    "svgo": "^4.0.2",
+    "svgo": "~4.0.0",
-    "typescript": "~7.0.2",
+    "typescript": "~5.9.3",
-    "vite": "^8.1.5",
+    "vite": "8.0.0-beta.2",
-    "vite-bundle-analyzer": "^1.3.9"
+    "vite-bundle-analyzer": "~1.3.1"
   }
 }

client/simple/src/js/Plugin.ts

@@ -23,7 +23,7 @@ export abstract class Plugin {
   protected constructor(id: string) {
     this.id = id;
 
-    queueMicrotask(() => this.invoke());
+    void this.invoke();
   }
 
   private async invoke(): Promise<void> {

client/simple/src/js/main/autocomplete.ts

@@ -44,6 +44,8 @@ const fetchResults = async (qInput: HTMLInputElement, query: string): Promise<vo
 
         const form = document.querySelector<HTMLFormElement>("#search");
         form?.submit();
+
+        autocomplete.classList.remove("open");
       });
 
       fragment.append(li);
@@ -78,11 +80,6 @@ listen("input", qInput, () => {
 const autocomplete: HTMLElement | null = document.querySelector<HTMLElement>(".autocomplete");
 const autocompleteList: HTMLUListElement | null = document.querySelector<HTMLUListElement>(".autocomplete ul");
 if (autocompleteList) {
-  listen("keydown", qInput, (event: KeyboardEvent) => {
-    if (event.key === "Escape") {
-      autocomplete?.classList.remove("open");
-    }
-  });
   listen("keyup", qInput, (event: KeyboardEvent) => {
     const listItems = [...autocompleteList.children] as HTMLElement[];
 
@@ -108,6 +105,7 @@ if (autocompleteList) {
         newCurrentIndex = (currentIndex + 1) % listItems.length;
         break;
       }
+      case "Tab":
       case "Enter":
         if (autocomplete) {
           autocomplete.classList.remove("open");
@@ -131,12 +129,4 @@ if (autocompleteList) {
       }
     }
   });
-
-  listen("blur", qInput, () => {
-    autocomplete?.classList.remove("open");
-  });
-
-  listen("focus", qInput, () => {
-    autocomplete?.classList.add("open");
-  });
 }

client/simple/src/js/main/keyboard.ts

@@ -190,7 +190,9 @@ const highlightResult =
 
     let next: HTMLElement | undefined;
 
-    if (typeof effectiveWhich === "string") {
+    if (typeof effectiveWhich !== "string") {
+      next = effectiveWhich;
+    } else {
       switch (effectiveWhich) {
         case "visible": {
           const top = document.documentElement.scrollTop || document.body.scrollTop;
@@ -218,10 +220,8 @@ const highlightResult =
         // biome-ignore lint/complexity/noUselessSwitchCase: fallthrough is intended
         case "top":
         default:
-          [next] = results;
+          next = results[0];
       }
-    } else {
-      next = effectiveWhich;
     }
 
     if (next) {
@@ -343,7 +343,7 @@ const initHelpContent = (divElement: HTMLElement, keyBindings: typeof baseKeyBin
   const categories: Record<string, KeyBinding[]> = {};
 
   for (const binding of Object.values(keyBindings)) {
-    const { cat } = binding;
+    const cat = binding.cat;
     categories[cat] ??= [];
     categories[cat].push(binding);
   }
@@ -400,7 +400,7 @@ const toggleHelp = (keyBindings: typeof baseKeyBinding): void => {
       className: "dialog-modal"
     });
     initHelpContent(helpPanel, keyBindings);
-    const [body] = document.getElementsByTagName("body");
+    const body = document.getElementsByTagName("body")[0];
     if (body) {
       body.appendChild(helpPanel);
     }

client/simple/src/js/main/preferences.ts

@@ -70,7 +70,8 @@ listen("click", "#copy-hash", async function (this: HTMLElement) {
     }
   }
 
-  if (this.dataset.copiedText) {
+  const copiedText = this.dataset.copiedText;
-    this.innerText = this.dataset.copiedText;
+  if (copiedText) {
+    this.innerText = copiedText;
   }
 });

client/simple/src/js/main/results.ts

@@ -35,9 +35,8 @@ const imageLoader = (resultElement: HTMLElement): void => {
   }, 1000) as unknown as number;
 };
 
-const imageThumbnails: NodeListOf<HTMLImageElement> = document.querySelectorAll<HTMLImageElement>(
+const imageThumbnails: NodeListOf<HTMLImageElement> =
-  "#urls img.image_thumbnail, img.thumbnail"
+  document.querySelectorAll<HTMLImageElement>("#urls img.image_thumbnail");
-);
 for (const thumbnail of imageThumbnails) {
   if (thumbnail.complete && thumbnail.naturalWidth === 0) {
     thumbnail.src = `${settings.theme_static_path}/img/img_load_error.svg`;
@@ -136,8 +135,9 @@ listen("click", "#copy_url", async function (this: HTMLElement) {
     }
   }
 
-  if (this.dataset.copiedText) {
+  const copiedText = this.dataset.copiedText;
-    this.innerText = this.dataset.copiedText;
+  if (copiedText) {
+    this.innerText = copiedText;
   }
 });
 

client/simple/src/js/plugin/Calculator.ts

@@ -77,9 +77,9 @@ export default class Calculator extends Plugin {
 
   protected async run(): Promise<string | undefined> {
     const searchInput = getElement<HTMLInputElement>("q");
+    const node = Calculator.math.parse(searchInput.value);
 
     try {
-      const node = Calculator.math.parse(searchInput.value);
       return `${node.toString()} = ${node.evaluate()}`;
     } catch {
       // not a compatible math expression

client/simple/src/js/plugin/MapView.ts

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-import "ol/ol.css";
+import "ol/ol.css?inline";
 import { Feature, Map as OlMap, View } from "ol";
 import { GeoJSON } from "ol/format";
 import { Point } from "ol/geom";
@@ -23,10 +23,10 @@ export default class MapView extends Plugin {
   }
 
   protected async run(): Promise<void> {
-    const { leafletTarget: target, mapLon = "0", mapLat = "0", mapGeojson } = this.map.dataset;
+    const { leafletTarget: target, mapLon, mapLat, mapGeojson } = this.map.dataset;
 
-    const lon = Number.parseFloat(mapLon);
+    const lon = Number.parseFloat(mapLon || "0");
-    const lat = Number.parseFloat(mapLat);
+    const lat = Number.parseFloat(mapLat || "0");
     const view = new View({ maxZoom: 16, enableRotation: false });
     const map = new OlMap({
       target: target,
@@ -77,10 +77,7 @@ export default class MapView extends Plugin {
 
         map.addLayer(geoLayer);
 
-        const geoSourceExtent = geoSource.getExtent();
+        view.fit(geoSource.getExtent(), { padding: [20, 20, 20, 20] });
-        if (geoSourceExtent) {
-          view.fit(geoSourceExtent, { padding: [20, 20, 20, 20] });
-        }
       } catch (error) {
         console.error("Failed to create GeoJSON layer:", error);
       }

client/simple/src/js/toolkit.ts

@@ -5,6 +5,7 @@ import type { KeyBindingLayout } from "./main/keyboard.ts";
 // synced with searx/webapp.py get_client_settings
 type Settings = {
   plugins?: string[];
+  advanced_search?: boolean;
   autocomplete?: string;
   autocomplete_min?: number;
   doi_resolver?: string;
@@ -122,10 +123,10 @@ export const ready = (callback: () => void, options?: ReadyOptions): void => {
     }
   }
 
-  if (document.readyState === "loading") {
+  if (document.readyState !== "loading") {
-    listen("DOMContentLoaded", document, callback, { once: true });
-  } else {
     callback();
+  } else {
+    listen("DOMContentLoaded", document, callback, { once: true });
   }
 };
 

client/simple/src/less/new_issue.less

@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+.stats_endpoint {
+  .github-issue-button {
+    display: block;
+    font-size: 16px;
+  }
+
+  .issue-hide {
+    display: none;
+  }
+
+  input[type="checked"] {
+    position: absolute;
+  }
+
+  label {
+    margin: 1rem 1rem 1rem 0;
+  }
+
+  .step_content {
+    margin: 1rem 1rem 1rem 2rem;
+  }
+
+  .step1,
+  .step2 {
+    visibility: hidden;
+  }
+
+  .step1_delay {
+    transition: visibility 0s linear 4s;
+  }
+
+  #step1:checked ~ .step1,
+  #step2:checked ~ .step2 {
+    visibility: visible;
+  }
+}

client/simple/src/less/result_types/keyvalue.less

@@ -17,7 +17,7 @@
   }
 
   table {
-    word-break: break-all;
+    word-break: break-word;
     table-layout: fixed;
     width: 100%;
     background-color: var(--color-result-keyvalue-table);

client/simple/src/less/result_types/paper.less

@@ -41,7 +41,7 @@
     font-size: 0.9rem;
     margin: 0.25rem 0 0 0;
     padding: 0;
-    overflow-wrap: break-word;
+    word-wrap: break-word;
     line-height: 1.24;
     font-style: italic;
   }

client/simple/src/less/style.less

@@ -7,9 +7,11 @@
 @import "mixins.less";
 @import "toolkit.less";
 @import "autocomplete.less";
+@import "detail.less";
 @import "animations.less";
 @import "embedded.less";
 @import "info.less";
+@import "new_issue.less";
 @import "stats.less";
 @import "result_templates.less";
 @import "weather.less";
@@ -186,7 +188,7 @@ article[data-vim-selected].category-social {
 
   h3 {
     font-size: 1.2rem;
-    overflow-wrap: break-word;
+    word-wrap: break-word;
     margin: 0.4rem 0 0.4rem 0;
     padding: 0;
 
@@ -220,7 +222,7 @@ article[data-vim-selected].category-social {
     margin: 0;
     padding: 0;
     max-width: 54em;
-    overflow-wrap: break-word;
+    word-wrap: break-word;
     line-height: 1.24;
 
     .highlight {
@@ -364,7 +366,7 @@ article[data-vim-selected].category-social {
     font-size: 0.9rem;
     margin: 0.25rem 0 0 0;
     padding: 0;
-    overflow-wrap: break-word;
+    word-wrap: break-word;
     line-height: 1.24;
     font-style: italic;
   }
@@ -569,16 +571,13 @@ article[data-vim-selected].category-social {
 
 #suggestions {
   .wrapper {
-    padding-left: 0;
+    display: flex;
-    margin: 0;
+    flex-flow: column;
-    list-style-position: inside;
+    justify-content: flex-end;
-
-    li::marker {
-      color: var(--color-result-link-font);
-    }
 
     form {
       display: inline-block;
+      flex: 1 1 50%;
     }
   }
 }
@@ -586,8 +585,8 @@ article[data-vim-selected].category-social {
 #suggestions,
 #infoboxes {
   input {
-    padding: 3px;
+    padding: 0;
-    margin: 0;
+    margin: 3px;
     font-size: 0.9em;
     display: inline-block;
     background: transparent;
@@ -689,7 +688,7 @@ summary.title {
 
 #sidebar {
   grid-area: sidebar;
-  overflow-wrap: break-word;
+  word-wrap: break-word;
   color: var(--color-sidebar-font);
 
   .infobox {
@@ -1030,6 +1029,10 @@ summary.title {
     / 100%;
   gap: 0;
 
+  #sidebar {
+    display: none;
+  }
+
   #urls {
     margin: 0;
     display: flex;
@@ -1164,4 +1167,3 @@ pre code {
 @import "result_types/code.less";
 @import "result_types/paper.less";
 @import "result_types/file.less";
-@import "result_types/image.less";

client/simple/src/less/toolkit.less

@@ -610,7 +610,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: var(--color-base-font);
-  border: 1px solid rgb(var(--color-base-font-rgb), 0.9);
+  border: 1px solid rgba(var(--color-base-font-rgb), 0.9);
   padding: 0.3rem 0;
 }
 
@@ -618,7 +618,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border: 1px solid rgb(var(--color-base-font-rgb), 0.3);
+  border: 1px solid rgba(var(--color-base-font-rgb), 0.3);
   padding: 0.3rem 0;
 }
 
@@ -626,7 +626,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border-bottom: 1px dotted rgb(var(--color-base-font-rgb), 0.5);
+  border-bottom: 1px dotted rgba(var(--color-base-font-rgb), 0.5);
   padding: 0;
 }
 
@@ -634,7 +634,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border-left: 1px solid rgb(var(--color-base-font-rgb), 0.9);
+  border-left: 1px solid rgba(var(--color-base-font-rgb), 0.9);
   padding: 0.4rem 0;
   width: 1px;
 }

client/simple/tools/img.ts

@@ -18,10 +18,8 @@ export type Src2Dest = {
  * Convert a list of SVG files to PNG.
  *
  * @param items - Array of SVG files (src: SVG, dest:PNG) to convert.
- * @param width - (optional) width of the PNG pictures
- * @param height - (optional) height of the PNG pictures.
  */
-export const svg2png = (items: Src2Dest[], width?: number, height?: number): void => {
+export const svg2png = (items: Src2Dest[]): void => {
   for (const item of items) {
     fs.mkdirSync(path.dirname(item.dest), { recursive: true });
 
@@ -31,9 +29,6 @@ export const svg2png = (items: Src2Dest[], width?: number, height?: number): voi
         compressionLevel: 9,
         palette: true
       })
-      .resize(width, height, {
-        fit: "contain"
-      })
       .toFile(item.dest)
       .then((info) => {
         console.log(`[svg2png] created ${item.dest} -- bytes: ${info.size}, w:${info.width}px,  h:${info.height}px`);

client/simple/tools/plg.ts

@@ -17,15 +17,13 @@ import { type Src2Dest, svg2png, svg2svg } from "./img.ts";
  * Vite plugin to convert a list of SVG files to PNG.
  *
  * @param items - Array of SVG files (src: SVG, dest:PNG) to convert.
- * @param width - (optional) width of the PNG picture
- * @param height - (optional) height of the PNG picture
  */
-export const plg_svg2png = (items: Src2Dest[], width?: number, height?: number): Plugin => {
+export const plg_svg2png = (items: Src2Dest[]): Plugin => {
   return {
     name: "searxng-simple-svg2png",
     apply: "build",
     writeBundle: () => {
-      svg2png(items, width, height);
+      svg2png(items);
     }
   };
 };

client/simple/tsconfig.json

@@ -31,6 +31,7 @@
     "noUnusedParameters": true,
     "verbatimModuleSyntax": true,
 
+    "baseUrl": ".",
     "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
     "types": ["vite/client"]
   },

client/simple/vite.config.ts

@@ -34,7 +34,7 @@ const svg2svg_favicon_opts: Config = {
 };
 
 export default {
-  base: "./",
+  base: "/static/themes/simple/",
   publicDir: "static/",
 
   build: {
@@ -74,9 +74,6 @@ export default {
             .normalize("NFD")
             .replace(/[^a-zA-Z0-9.-]/g, "_")
             .toLowerCase();
-        },
-        comments: {
-          legal: true
         }
       }
     }
@@ -132,28 +129,6 @@ export default {
       }
     ]),
 
-    // SearXNG PWA Icons (static)
-    plg_svg2png(
-      [
-        {
-          src: `${PATH.brand}/searxng-wordmark.svg`,
-          dest: `${PATH.dist}/img/512.png`
-        }
-      ],
-      512,
-      512
-    ),
-    plg_svg2png(
-      [
-        {
-          src: `${PATH.brand}/searxng-wordmark.svg`,
-          dest: `${PATH.dist}/img/192.png`
-        }
-      ],
-      192,
-      192
-    ),
-
     // -- svg
     plg_svg2svg(
       [

container/.env.example

@@ -1,15 +0,0 @@
-# Read the documentation before using the `docker-compose.yml` file:
-# https://docs.searxng.org/admin/installation-docker.html
-#
-# Additional ENVs:
-# https://docs.searxng.org/admin/settings/settings_general.html#settings-general
-# https://docs.searxng.org/admin/settings/settings_server.html#settings-server
-
-# Use a specific version tag. E.g. "latest" or "2026.3.25-541c6c3cb".
-#SEARXNG_VERSION=latest
-
-# Listen to a specific address.
-#SEARXNG_HOST=[::]
-
-# Listen to a specific port.
-#SEARXNG_PORT=8080

container/builder.dockerfile

@@ -1,4 +1,4 @@
-FROM docker.io/searxng/base:searxng-builder AS builder
+FROM ghcr.io/searxng/base:searxng-builder AS builder
 
 COPY ./requirements.txt ./requirements-server.txt ./
 
@@ -21,6 +21,8 @@ RUN --mount=type=cache,id=uv,target=/root/.cache/uv set -eux -o pipefail; \
 
 COPY --exclude=./searx/version_frozen.py ./searx/ ./searx/
 
+ARG TIMESTAMP_SETTINGS="0"
+
 RUN set -eux -o pipefail; \
     python -m compileall -q -f -j 0 --invalidation-mode=unchecked-hash ./searx/; \
     find ./searx/static/ -type f \
@@ -28,4 +30,5 @@ RUN set -eux -o pipefail; \
     -exec gzip -9 -k {} + \
     -exec brotli -9 -k {} + \
     -exec gzip --test {}.gz + \
-    -exec brotli --test {}.br +
+    -exec brotli --test {}.br +; \
+    touch -c --date="@$TIMESTAMP_SETTINGS" ./searx/settings.yml

container/dist.dockerfile

@@ -2,7 +2,7 @@ ARG CONTAINER_IMAGE_ORGANIZATION="searxng"
 ARG CONTAINER_IMAGE_NAME="searxng"
 
 FROM localhost/$CONTAINER_IMAGE_ORGANIZATION/$CONTAINER_IMAGE_NAME:builder AS builder
-FROM docker.io/searxng/base:searxng AS dist
+FROM ghcr.io/searxng/base:searxng AS dist
 
 COPY --chown=977:977 --from=builder /usr/local/searxng/.venv/ ./.venv/
 COPY --chown=977:977 --from=builder /usr/local/searxng/searx/ ./searx/
@@ -15,17 +15,17 @@ ARG VCS_URL="unknown"
 ARG VCS_REVISION="unknown"
 
 LABEL org.opencontainers.image.created="$CREATED" \
-    org.opencontainers.image.description="SearXNG is a metasearch engine. Users are neither tracked nor profiled." \
+      org.opencontainers.image.description="SearXNG is a metasearch engine. Users are neither tracked nor profiled." \
-    org.opencontainers.image.documentation="https://docs.searxng.org/admin/installation-docker" \
+      org.opencontainers.image.documentation="https://docs.searxng.org/admin/installation-docker" \
-    org.opencontainers.image.licenses="AGPL-3.0-or-later" \
+      org.opencontainers.image.licenses="AGPL-3.0-or-later" \
-    org.opencontainers.image.revision="$VCS_REVISION" \
+      org.opencontainers.image.revision="$VCS_REVISION" \
-    org.opencontainers.image.source="$VCS_URL" \
+      org.opencontainers.image.source="$VCS_URL" \
-    org.opencontainers.image.title="SearXNG" \
+      org.opencontainers.image.title="SearXNG" \
-    org.opencontainers.image.url="https://searxng.org" \
+      org.opencontainers.image.url="https://searxng.org" \
-    org.opencontainers.image.version="$VERSION"
+      org.opencontainers.image.version="$VERSION"
 
-ENV __SEARXNG_VERSION="$VERSION" \
+ENV SEARXNG_VERSION="$VERSION" \
-    __SEARXNG_SETTINGS_PATH="$__SEARXNG_CONFIG_PATH/settings.yml" \
+    SEARXNG_SETTINGS_PATH="$CONFIG_PATH/settings.yml" \
     GRANIAN_PROCESS_NAME="searxng" \
     GRANIAN_INTERFACE="wsgi" \
     GRANIAN_HOST="::" \
@@ -36,8 +36,8 @@ ENV __SEARXNG_VERSION="$VERSION" \
     GRANIAN_BLOCKING_THREADS_IDLE_TIMEOUT="5m"
 
 # "*_PATH" ENVs are defined in base images
-VOLUME $__SEARXNG_CONFIG_PATH
+VOLUME $CONFIG_PATH
-VOLUME $__SEARXNG_DATA_PATH
+VOLUME $DATA_PATH
 
 EXPOSE 8080
 

container/docker-compose.yml

@@ -1,28 +0,0 @@
-# Read the documentation before using the `docker-compose.yml` file:
-# https://docs.searxng.org/admin/installation-docker.html
-
-name: searxng
-
-services:
-  core:
-    container_name: searxng-core
-    image: docker.io/searxng/searxng:${SEARXNG_VERSION:-latest}
-    restart: always
-    ports:
-      - ${SEARXNG_HOST:+${SEARXNG_HOST}:}${SEARXNG_PORT:-8080}:${SEARXNG_PORT:-8080}
-    env_file: ./.env
-    volumes:
-      - ./core-config/:/etc/searxng/:Z
-      - core-data:/var/cache/searxng/
-
-  valkey:
-    container_name: searxng-valkey
-    image: docker.io/valkey/valkey:9-alpine
-    command: valkey-server --save 30 1 --loglevel warning
-    restart: always
-    volumes:
-      - valkey-data:/data/
-
-volumes:
-  core-data:
-  valkey-data:

container/entrypoint.sh

@@ -77,50 +77,56 @@ volume_handler() {
     setup_ownership "$target" "directory"
 }
 
-setup() {
+# Handle configuration file updates
-    local template_settings="/usr/local/searxng/settings.template.yml"
+config_handler() {
-    local target_settings="$__SEARXNG_CONFIG_PATH/settings.yml"
+    local target="$1"
+    local template="$2"
+    local new_template_target="$target.new"
 
-    if [ ! -f "$target_settings" ]; then
+    # Create/Update the configuration file
+    if [ -f "$target" ]; then
+        setup_ownership "$target" "file"
+
+        if [ "$template" -nt "$target" ]; then
+            cp -pfT "$template" "$new_template_target"
+
+            cat <<EOF
+...
+... INFORMATION
+... Update available for "$target"
+... It is recommended to update the configuration file to ensure proper functionality
+...
+... New version placed at "$new_template_target"
+... Please review and merge changes
+...
+EOF
+        fi
+    else
         cat <<EOF
 ...
 ... INFORMATION
-... "$target_settings" does not exist, creating from template...
+... "$target" does not exist, creating from template...
 ...
 EOF
-        cp -pfT "$template_settings" "$target_settings"
+        cp -pfT "$template" "$target"
 
-        sed -i "s/ultrasecretkey/$(head -c 24 /dev/urandom | base64 | tr -dc 'a-zA-Z0-9')/g" "$target_settings"
+        sed -i "s/ultrasecretkey/$(head -c 24 /dev/urandom | base64 | tr -dc 'a-zA-Z0-9')/g" "$target"
     fi
 
-    check_file "$target_settings"
+    check_file "$target"
 }
 
 cat <<EOF
-SearXNG $__SEARXNG_VERSION
+SearXNG $SEARXNG_VERSION
 EOF
 
 # Check for volume mounts
-volume_handler "$__SEARXNG_CONFIG_PATH"
+volume_handler "$CONFIG_PATH"
-volume_handler "$__SEARXNG_DATA_PATH"
+volume_handler "$DATA_PATH"
 
-setup
+# Check for files
+config_handler "$SEARXNG_SETTINGS_PATH" "/usr/local/searxng/searx/settings.yml"
 
-# root only features
+update-ca-certificates
-if [ "$(id -u)" -eq 0 ]; then
-    update-ca-certificates
-fi
-
-# ENVs aliases
-# https://github.com/searxng/searxng/issues/5934
-case "${SEARXNG_PORT:-}" in
-    '') ;;
-    *[!0-9]*)
-        unset SEARXNG_PORT
-        ;;
-    *)
-        export GRANIAN_PORT="$SEARXNG_PORT"
-        ;;
-esac
 
 exec /usr/local/searxng/.venv/bin/granian searx.webapp:app

container/settings.template.yml

@@ -1,8 +0,0 @@
-# Read the documentation before extending the defaults:
-# https://docs.searxng.org/admin/settings/
-
-use_default_settings: true
-
-server:
-  secret_key: "ultrasecretkey"
-  image_proxy: true

docs/_static/searxng.css

@@ -1,57 +0,0 @@
-.content {
-  width: 52em;    /*  instead of 46em */
-}
-
-p code.literal {
-  text-wrap: nowrap;
-}
-
-aside.sidebar {
-  border-color: lightsteelblue;
-  border-radius: 3pt;
-}
-
-p.sidebar-title, .sidebar p {
-  margin: 6pt;
-}
-
-.sidebar li,
-.hlist li {
-  list-style-type: disclosure-closed;
-}
-
-.sphinxsidebar .current > a {
-  font-weight: bold;
-}
-
-/* admonitions with (rendered) reST markup examples (:class: rst-example)
- *
- * .. admonition:: title of the example
- *     :class: rst-example
- *     ....
-*/
-
-div.rst-example {
-  background-color: inherit;
-  margin: 0;
-  border-top: none;
-  border-right: 1px solid #ccc;
-  border-bottom: none;
-  border-left: none;
-  border-radius: none;
-  padding: 0;
-}
-
-div.rst-example > p.admonition-title {
-  font-family: Sans Serif;
-  font-style: italic;
-  font-size: 0.8em;
-  display: block;
-  border-bottom: 1px solid #ccc;
-  padding: 0.5em 1em;
-  text-align: right;
-}
-
-div.sphinx-tabs {
-    clear: both;
-}

docs/_themes/searxng/static/searxng.css

@@ -0,0 +1,151 @@
+@import url("pocoo.css");
+
+a, a.reference, a.footnote-reference {
+  color: #004b6b;
+  border-color: #004b6b;
+}
+
+a:hover {
+  color: #6d4100;
+  border-color: #6d4100;
+}
+
+p.version-warning {
+  background-color: #004b6b;
+}
+
+aside.sidebar {
+  background-color: whitesmoke;
+  border-color: lightsteelblue;
+  border-radius: 3pt;
+}
+
+div.sphinxsidebar p.caption {
+  display: none;
+}
+
+p.sidebar-title, .sidebar p {
+  margin: 6pt;
+}
+
+.sidebar li,
+.hlist li {
+  list-style-type: disclosure-closed;
+}
+
+.sphinxsidebar .current > a {
+  font-weight: bold;
+}
+
+/* admonitions
+*/
+
+div.admonition, div.topic, nav.contents, div.toctree-wrapper {
+  background-color: #fafafa;
+  margin: 8px 0px;
+  padding: 1em;
+  border-radius: 3pt 0 0 3pt;
+  border-top: none;
+  border-right: none;
+  border-bottom: none;
+  border-left: 5pt solid #ccc;
+  list-style-type: disclosure-closed;
+}
+
+div.toctree-wrapper p.caption {
+  font-weight: normal;
+  font-size: 24px;
+  margin: 0 0 10px 0;
+  padding: 0;
+  line-height: 1;
+  display: inline;
+}
+
+p.admonition-title:after {
+  content: none;
+}
+
+.admonition.hint      { border-color: #416dc0b0; }
+.admonition.note      { border-color: #6c856cb0; }
+.admonition.tip       { border-color: #85c5c2b0; }
+.admonition.attention { border-color: #ecec97b0; }
+.admonition.caution   { border-color: #a6c677b0; }
+.admonition.danger    { border-color: #d46262b0; }
+.admonition.important { border-color: #dfa3a3b0; }
+.admonition.error     { border-color: red; }
+.admonition.warning   { border-color: darkred; }
+
+.admonition.admonition-generic-admonition-title {
+    border-color: #416dc0b0;
+}
+
+
+/* admonitions with (rendered) reST markup examples (:class: rst-example)
+ *
+ * .. admonition:: title of the example
+ *     :class: rst-example
+ *     ....
+*/
+
+div.rst-example {
+  background-color: inherit;
+  margin: 0;
+  border-top: none;
+  border-right: 1px solid #ccc;
+  border-bottom: none;
+  border-left: none;
+  border-radius: none;
+  padding: 0;
+}
+
+div.rst-example > p.admonition-title {
+  font-family: Sans Serif;
+  font-style: italic;
+  font-size: 0.8em;
+  display: block;
+  border-bottom: 1px solid #ccc;
+  padding: 0.5em 1em;
+  text-align: right;
+}
+
+/* code block in figures
+ */
+
+div.highlight pre {
+    text-align: left;
+}
+
+/* Table theme
+*/
+
+thead, tfoot {
+  background-color: #fff;
+}
+
+th:hover, td:hover {
+  background-color: #ffc;
+}
+
+thead th, tfoot th, tfoot td, tbody th {
+  background-color: #fffaef;
+}
+
+tbody tr:nth-child(odd) {
+  background-color: #fff;
+}
+
+tbody tr:nth-child(even) {
+  background-color: #fafafa;
+}
+
+caption {
+  font-family: Sans Serif;
+  padding: 0.5em;
+  margin: 0.5em 0 0.5em 0;
+  caption-side: top;
+  text-align: left;
+}
+
+div.sphinx-tabs {
+    clear: both;
+}

docs/_themes/searxng/theme.conf

@@ -0,0 +1,7 @@
+[theme]
+inherit = pocoo
+stylesheet = searxng.css
+
+[options]
+touch_icon =
+globaltoc_maxdepth = 5

docs/admin/buildhosts.rst

@@ -4,6 +4,11 @@
 Buildhosts
 ==========
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 To get best results from build, it's recommend to install additional packages on
 build hosts (see :ref:`searxng.sh`).
 

docs/admin/installation-apache.rst

@@ -61,6 +61,11 @@ section might give you some guidance.
    - `Apache Fedora`_
    - `Apache directives`_
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 
 The Apache HTTP server
 ======================

docs/admin/installation-docker.rst

@@ -9,6 +9,7 @@ Installation container
 .. _Podman rootless containers: https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md
 .. _DockerHub mirror: https://hub.docker.com/r/searxng/searxng
 .. _GHCR mirror: https://ghcr.io/searxng/searxng
+.. _Docker compose: https://github.com/searxng/searxng-docker
 
 .. sidebar:: info
 
@@ -26,7 +27,7 @@ Installation container
    `Docker 101`_ before proceeding.
 
 Container images are the basis for deployments in containerized environments,
-Compose, Kubernetes and more.
+`Docker compose`_, Kubernetes and more.
 
 .. _Container installation:
 
@@ -54,10 +55,10 @@ In the case of Docker, you need to add the user running the container to the
 In the case of Podman, no additional steps are generally required, but there
 are some considerations when running `Podman rootless containers`_.
 
-.. _Container registries:
+.. _Container pulling images:
 
-Registries
+Pulling images
-----------
+--------------
 
 .. note::
 
@@ -69,115 +70,26 @@ The official images are mirrored at:
 - `DockerHub mirror`_
 - `GHCR mirror`_ (GitHub Container Registry)
 
-.. _Container compose instancing:
+Pull the latest image:
-
-Compose instancing
-==================
-
-This is the recommended way to deploy SearXNG in a containerized environment.
-Compose templates allow you to define container configurations in a
-declarative manner.
-
-.. _Container compose instancing setup:
-
-Setup
------
-
-1. Create the environment:
 
 .. code:: sh
 
-   # Create the environment and configuration directories
+   $ docker pull docker.io/searxng/searxng:latest
-   $ mkdir -p ./searxng/core-config/
-   $ cd ./searxng/
 
-   # Fetch the latest compose template
+\.\. or if you want to lock in to a specific version:
-   $ 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
-
-2. Copy the ``.env.example`` file and edit the values as needed:
 
 .. code:: sh
 
-   $ cp -i .env.example .env
+   $ docker pull docker.io/searxng/searxng:2025.8.1-3d96414
 
-   # nano or your preferred text editor...
+.. _Container instancing:
-   $ nano .env
 
-3. Start & stop the services:
+Instancing
-
+==========
-.. code:: sh
-
-   $ docker compose up -d
-   $ docker compose down
-
-4. Setup your settings in ``core-config/settings.yml`` according to your preferences.
-
-.. _Container compose instancing maintenance:
-
-Management
-----------
-
-.. important::
-
-    Remember to review the new templates for any changes that may affect your
-    deployment, and update the ``.env`` file accordingly.
-
-To update the templates to their latest versions:
-
-.. code:: sh
-
-   $ docker compose down
-   $ curl -fsSLO \
-       https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
-       https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example
-   $ docker compose up -d
-
-To update the services to their latest versions:
-
-.. code:: sh
-
-   $ docker compose down
-   $ docker compose pull
-   $ docker compose up -d
-
-List running services:
-
-.. code:: sh
-
-   $ docker compose ps
-   NAME            IMAGE  ...  CREATED        STATUS        PORTS
-   searxng-core    ...    ...  3 minutes ago  Up 3 minutes  0.0.0.0:8080->8080/tcp
-   searxng-valkey  ...    ...  3 minutes ago  Up 3 minutes  6379/tcp
-
-Print a service container logs:
-
-.. code:: sh
-
-   $ docker compose logs -f core
-
-Access a service container shell (troubleshooting):
-
-.. code:: sh
-
-   $ docker compose exec -it --user root core /bin/sh -l
-   /usr/local/searxng #
-
-Stop and remove the services:
-
-.. code:: sh
-
-   $ docker compose down
-
-.. _Container manual instancing:
-
-Manual instancing
-=================
 
 This section is intended for advanced users who need custom deployments.  We
-recommend using `Container compose instancing`_, which provides a preconfigured
+recommend using `Docker compose`_, which provides a preconfigured environment
-environment with sensible defaults.
+with sensible defaults.
 
 Basic container instancing example:
 
@@ -209,18 +121,12 @@ List running containers:
    CONTAINER ID  IMAGE  ...  CREATED        PORTS                   NAMES
    1af574997e63  ...    ...  3 minutes ago  0.0.0.0:8888->8080/tcp  searxng
 
-Print the container logs:
-
-.. code:: sh
-
-   $ docker container logs -f searxng
-
 Access the container shell (troubleshooting):
 
 .. code:: sh
 
    $ docker container exec -it --user root searxng /bin/sh -l
-   /usr/local/searxng #
+   1af574997e63:/usr/local/searxng#
 
 Stop and remove the container:
 
@@ -247,12 +153,18 @@ Environment variables
 The following environment variables can be configured:
 
 - ``$SEARXNG_*``: Controls the SearXNG configuration options, look out for
-  environment ``$SEARXNG_*`` in :ref:`settings server`, :ref:`settings
+  environment ``$SEARXNG_*`` in :ref:`settings server` and :ref:`settings
-  general` and the :origin:`container/.env.example` template.
+  general`.
 - ``$GRANIAN_*``: Controls the :ref:`Granian server options <Granian configuration>`.
 - ``$FORCE_OWNERSHIP``: Ensures mounted volumes/files are owned by the
   ``searxng:searxng`` user (default: ``true``)
 
+Container internal paths (don't modify unless you know what you're doing):
+
+- ``$CONFIG_PATH``: Path to the SearXNG configuration directory (default: ``/etc/searxng``)
+- ``$SEARXNG_SETTINGS_PATH``: Path to the SearXNG settings file (default: ``$CONFIG_PATH/settings.yml``)
+- ``$DATA_PATH``: Path to the SearXNG data directory (default: ``/var/cache/searxng``)
+
 .. _Container custom certificates:
 
 Custom certificates
@@ -264,8 +176,6 @@ additional certificates as needed.
 They will be available on container (re)start or when running
 ``update-ca-certificates`` in the container shell.
 
-This requires the container to be running with ``root`` privileges.
-
 .. _Container custom images:
 
 Custom images
@@ -283,67 +193,9 @@ container images are not officially supported):
    $ make container
 
    $ docker images
-   REPOSITORY                 TAG                  IMAGE ID  SIZE
+   REPOSITORY                 TAG                 IMAGE ID  CREATED             SIZE
-   localhost/searxng/searxng  2026.6.19-93f66bfb4  ...       265 MB
+   localhost/searxng/searxng  2025.8.1-3d96414    ...       About a minute ago  183 MB
-   localhost/searxng/searxng  latest               ...       265 MB
+   localhost/searxng/searxng  latest              ...       About a minute ago  183 MB
-   localhost/searxng/searxng  builder              ...       687 MB
+   localhost/searxng/searxng  builder             ...       About a minute ago  524 MB
-   docker.io/searxng/base     searxng-builder      ...       565 MB
+   ghcr.io/searxng/base       searxng-builder     ...       2 days ago          378 MB
-   docker.io/searxng/base     searxng              ...       143 MB
+   ghcr.io/searxng/base       searxng             ...       2 days ago          42.2 MB
-
-Migrate from ``searxng-docker``
-===============================
-
-We expect the following source directory structure:
-
-.. code:: sh
-
-   .
-   └── searxng-docker
-       ├── searxng
-       │   ├── favicons.toml
-       │   ├── limiter.toml
-       │   ├── settings.yml
-       │   └── ...
-       ├── .env
-       ├── Caddyfile
-       ├── docker-compose.yml
-       └── ...
-
-Create a brand new environment outside ``searxng-docker`` directory, following
-`Container compose instancing setup`_.
-
-Once up and running, stop the services and move the configuration files from
-the old mount to the new one:
-
-.. code:: sh
-
-   $ mv ./searxng-docker/searxng/* ./searxng/core-config/
-
-If using Valkey features like bot protection (limiter), you will need to update
-the URL hostname in :origin:`searx/settings.yml` file to ``valkey`` or
-``searxng-valkey``.
-
-If you have any environment variables in the old ``.env`` file, make
-sure to add them to the new one.
-
-Consider setting up a reverse proxy if exposing the instance to the public.
-
-You should end with the following directory structure:
-
-.. code:: sh
-
-    .
-    ├── searxng
-    │   ├── core-config
-    │   │   ├── favicons.toml
-    │   │   ├── limiter.toml
-    │   │   ├── settings.yml
-    │   │   └── ...
-    │   ├── .env.example
-    │   ├── .env
-    │   └── docker-compose.yml
-    └── searxng-docker
-        └── ...
-
-If everything is working on the new environment, you can remove the old
-``searxng-docker`` directory and its contents.

docs/admin/installation-nginx.rst

@@ -41,6 +41,12 @@ section might give you some guidance.
    - `uWSGI support from nginx`_
 
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 The nginx HTTP server
 =====================
 

docs/admin/installation-searxng.rst

@@ -4,6 +4,12 @@
 Step by step installation
 =========================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 In this section we show the setup of a SearXNG instance that will be installed
 by the :ref:`installation scripts`.
 

docs/admin/installation-uwsgi.rst

@@ -9,6 +9,12 @@ uWSGI
    - `systemd.unit`_
    - `uWSGI Emperor`_
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _systemd.unit: https://www.freedesktop.org/software/systemd/man/systemd.unit.html
 .. _One service per app in systemd:
     https://uwsgi-docs.readthedocs.io/en/latest/Systemd.html#one-service-per-app-in-systemd

docs/admin/searx.favicons.rst

@@ -8,6 +8,11 @@ Favicons
 
    Don't activate the favicons before reading the documentation.
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 Activating the favicons in SearXNG is very easy, but this **generates a
 significantly higher load** in the client/server communication and increases
 resources needed on the server.
@@ -32,7 +37,7 @@ By default and without any extensions, SearXNG serves these resolvers:
 - ``yandex``
 
 With the above setting favicons are displayed, the user has the option to
-deactivate this feature in their settings.  If the user is to have the option of
+deactivate this feature in his settings.  If the user is to have the option of
 selecting from several *resolvers*, a further setting is required / but this
 setting will be discussed :ref:`later <register resolvers>` in this article,
 first we have to setup the favicons cache.
@@ -245,3 +250,4 @@ into the *proxy*:
 .. _data URL:
    https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URLs
 .. _FQN: https://en.wikipedia.org/wiki/Fully_qualified_name
+

docs/admin/searx.limiter.rst

@@ -8,5 +8,10 @@ Limiter
 
    The limiter requires a :ref:`Valkey <settings valkey>` database.
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.limiter
    :members:

docs/admin/settings/index.rst

@@ -19,7 +19,6 @@ Settings
    settings_search
    settings_server
    settings_ui
-   settings_preferences
    settings_redis
    settings_valkey
    settings_outgoing

docs/admin/settings/settings.rst

@@ -12,6 +12,11 @@ file.
    - :ref:`use_default_settings.yml`
    - :ref:`search API`
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. _settings location:
 
 settings.yml location

docs/admin/settings/settings_engines.rst

@@ -124,17 +124,14 @@ engine is shown.  Most of the options have a default value or even are optional.
 
 ``api_key`` : optional
   In a few cases, using an API needs the use of a secret key.  How to obtain them
-  is described in the file.  Engines that require an API key are set to
+  is described in the file.
-  ``inactive: true`` by default.  To enable such an engine, provide the API key
-  and set ``inactive: false``.
 
 ``disabled`` : optional
   To disable by default the engine, but not deleting it.  It will allow the user
   to manually activate it in the settings.
 
 ``inactive``: optional
-  Remove the engine from the settings (*disabled & removed*).  This defaults to ``true`` for engines
+  Remove the engine from the settings (*disabled & removed*).
-  that require an API key, please see the ``api_key`` section if you want to enable such an engine.
 
 ``language`` : optional
   If you want to use another language for a specific engine, you can define it

docs/admin/settings/settings_plugins.rst

@@ -102,18 +102,11 @@ The built-in plugins are all located in the namespace `searx.plugins`.
 external plugins
 ================
 
-SearXNG supports :ref:`external plugins <dev plugin>` / there is no need to
-install one, SearXNG runs out of the box.
-
-`Only show green hosted results`_:
-  SearXNG plugin to check if a domain is part of the Green WEB.
-
-`SearXNG BM25 Reranker`_:
-  SearXNG plugin that reranks search results using BM25 text relevance scoring
-  to improve search quality.
-
 .. _Only show green hosted results:
-    https://github.com/return42/tgwf-searx-plugins/
+   https://github.com/return42/tgwf-searx-plugins/
 
-.. _SearXNG BM25 Reranker:
+SearXNG supports *external plugins* / there is no need to install one, SearXNG
-    https://github.com/Oaklight/searxng-bm25-reranker
+runs out of the box.
+
+- `Only show green hosted results`_
+- ..

docs/admin/settings/settings_preferences.rst

@@ -1,8 +0,0 @@
-.. _settings preferences:
-
-================
-``preferences:``
-================
-
-.. autoclass:: searx._settings.SettingsPref
-   :members:

docs/admin/settings/settings_search.rst

@@ -36,19 +36,18 @@
 
   - ``360search``
   - ``baidu``
-  - ``bing``
   - ``brave``
   - ``dbpedia``
   - ``duckduckgo``
   - ``google``
   - ``mwmbl``
   - ``naver``
-  - ``privacywall``
   - ``quark``
   - ``qwant``
   - ``seznam``
   - ``sogou``
   - ``startpage``
+  - ``stract``
   - ``swisscows``
   - ``wikipedia``
   - ``yandex``

docs/admin/settings/settings_server.rst

@@ -47,7 +47,6 @@
   activated:
 
   - :py:obj:`searx.botdetection.link_token` in the :ref:`limiter`
-  - :ref:`image_proxy`
 
 .. _image_proxy:
 

docs/admin/update-searxng.rst

@@ -9,6 +9,11 @@ SearXNG maintenance
    - :ref:`toolboxing`
    - :ref:`uWSGI maintenance`
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. _update searxng:
 
 How to update

docs/build-templates/searxng.rst

@@ -119,12 +119,8 @@ ${fedora_build}
        pip install -U pip
        pip install -U setuptools
        pip install -U wheel
-
-       # additional packages required for installation
        pip install -U pyyaml
        pip install -U msgspec
-       pip install -U typing-extensions
-       pip install -U pybind11
 
        # jump to SearXNG's working tree and install SearXNG into virtualenv
        (${SERVICE_USER})$ cd \"$SEARXNG_SRC\"
@@ -169,7 +165,7 @@ ${fedora_build}
        $ sudo -H -u ${SERVICE_USER} -i
        (${SERVICE_USER})$ cd ${SEARXNG_SRC}
        (${SERVICE_USER})$ export SEARXNG_SETTINGS_PATH=\"${SEARXNG_SETTINGS_PATH}\"
-       (${SERVICE_USER})$ python -m searx.webapp
+       (${SERVICE_USER})$ python searx/webapp.py
 
        # disable debug
        $ sudo -H sed -i -e \"s/debug : True/debug : False/g\" \"$SEARXNG_SETTINGS_PATH\"

docs/conf.py

@@ -1,7 +1,8 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 
-import os
+import  sys, os
 from pathlib import Path
+from pallets_sphinx_themes import ProjectLink
 
 from searx import get_setting
 from searx.version import VERSION_STRING, GIT_URL, GIT_BRANCH
@@ -97,6 +98,7 @@ extlinks['pull-searx'] = ('https://github.com/searx/searx/pull/%s', 'PR %s')
 extlinks['origin'] = (GIT_URL + '/blob/' + GIT_BRANCH + '/%s', 'git://%s')
 extlinks['patch'] = (GIT_URL + '/commit/%s', '#%s')
 extlinks['docs'] = (DOCS_URL + '/%s', 'docs: %s')
+extlinks['pypi'] = ('https://pypi.org/project/%s', 'PyPi: %s')
 extlinks['man'] = ('https://manpages.debian.org/jump?q=%s', '%s')
 #extlinks['role'] = (
 #    'https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-%s', '')
@@ -115,6 +117,7 @@ extensions = [
     'sphinx.ext.viewcode',
     "sphinx.ext.autodoc",
     "sphinx.ext.intersphinx",
+    "pallets_sphinx_themes",
     "sphinx_issues", # https://github.com/sloria/sphinx-issues/blob/master/README.rst
     "sphinx_jinja",  # https://github.com/tardyp/sphinx-jinja
     "sphinxcontrib.programoutput",  # https://github.com/NextThought/sphinxcontrib-programoutput
@@ -155,49 +158,15 @@ issues_github_path = "searxng/searxng"
 
 # HTML -----------------------------------------------------------------
 
-html_theme = "furo"
-html_theme_options = {
-    # link to project source at GitHub for editing and viewing docs code
-    "source_repository": "https://github.com/searxng/searxng/",
-    "source_branch": "master",
-    "source_directory": "docs/",
-
-    # Show link to repository & searx.space in footer
-    "footer_icons": [
-        {
-            "name": "GitHub",
-            "url": "https://github.com/searxng/searxng/",
-            "html": "💾",
-        },
-        {
-            "name": "searx.space",
-            "url": "https://searx.space/",
-            "html": "🌐",
-        },
-    ],
-}
-
-html_sidebars = {
-    "**": [
-        "sidebar/scroll-start.html",
-        "sidebar/brand.html",
-        "sidebar/search.html",
-        "sidebar/navigation.html",
-        "sidebar/ethical-ads.html",
-        "sidebar/scroll-end.html",
-    ]
-}
-
-html_static_path = ['_static']
-
-html_css_files = [
-    'searxng.css',
-]
-
 # https://searxng.github.io/searxng --> '/searxng/'
 # https://docs.searxng.org --> '/'
 notfound_urls_prefix = '/'
 
+sys.path.append(os.path.abspath('_themes'))
+sys.path.insert(0, os.path.abspath("../"))
+html_theme_path = ['_themes']
+html_theme = "searxng"
+
 # sphinx.ext.imgmath setup
 html_math_renderer = 'imgmath'
 imgmath_image_format = 'svg'
@@ -205,10 +174,34 @@ imgmath_font_size = 14
 # sphinx.ext.imgmath setup END
 
 html_show_sphinx = False
+html_theme_options = {"index_sidebar_logo": True}
+html_context = {"project_links": [] }
+html_context["project_links"].append(ProjectLink("Source", GIT_URL + '/tree/' + GIT_BRANCH))
+
+if WIKI_URL:
+    html_context["project_links"].append(ProjectLink("Wiki", WIKI_URL))
+if PUBLIC_INSTANCES:
+    html_context["project_links"].append(ProjectLink("Public instances", PUBLIC_INSTANCES))
+if ISSUE_URL:
+    html_context["project_links"].append(ProjectLink("Issue Tracker", ISSUE_URL))
+if PRIVACYPOLICY_URL:
+    html_context["project_links"].append(ProjectLink("Privacy Policy", PRIVACYPOLICY_URL))
+if CONTACT_URL:
+    html_context["project_links"].append(ProjectLink("Contact", CONTACT_URL))
+
+html_sidebars = {
+    "**": [
+        "globaltoc.html",
+        "project.html",
+        "relations.html",
+        "searchbox.html",
+        "sourcelink.html"
+    ],
+}
+singlehtml_sidebars = {"index": ["project.html", "localtoc.html"]}
 html_logo = "../client/simple/src/brand/searxng-wordmark.svg"
 html_title = "SearXNG Documentation ({})".format(VERSION_STRING)
 html_show_sourcelink = True
-html_copy_source = True
 
 # LaTeX ----------------------------------------------------------------
 

docs/dev/contribution_guide.rst

@@ -4,6 +4,11 @@
 How to contribute
 =================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 Prime directives: Privacy, Hackability
 ======================================
 

docs/dev/engines/demo/demo_offline.rst

@@ -4,6 +4,11 @@
 Demo Offline Engine
 ===================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.demo_offline
   :members:
 

docs/dev/engines/demo/demo_online.rst

@@ -4,6 +4,11 @@
 Demo Online Engine
 ==================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.demo_online
   :members:
 

docs/dev/engines/engine_overview.rst

@@ -4,6 +4,11 @@
 Engine Overview
 ===============
 
+.. contents::
+   :depth: 3
+   :local:
+   :backlinks: entry
+
 .. _metasearch-engine: https://en.wikipedia.org/wiki/Metasearch_engine
 
 .. sidebar:: Further reading ..
@@ -107,7 +112,7 @@ module:
    ======================= =========== ===========================================
    base_url                string      base-url, can be overwritten to use same
                                        engine on other URL
-   page_size               int         maximum number of results per request
+   number_of_results       int         maximum number of results per request
    language                string      ISO code of language and country like en_US
    api_key                 string      api-key if required by engine
    ======================= =========== ===========================================

docs/dev/engines/index.rst

@@ -4,6 +4,12 @@
 Engine Implementations
 ======================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. toctree::
    :caption: Framework Components
    :maxdepth: 2

docs/dev/engines/json_engine.rst

@@ -4,5 +4,10 @@
 JSON Engine
 ============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.json_engine
   :members:

docs/dev/engines/mediawiki.rst

@@ -4,5 +4,10 @@
 MediaWiki Engine
 ================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.mediawiki
   :members:

docs/dev/engines/offline/command-line-engines.rst

@@ -9,6 +9,11 @@ Command Line Engines
    - :origin:`command.py <searx/engines/command.py>`
    - :ref:`offline engines`
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. sidebar:: info
 
    Initial sponsored by `Search and Discovery Fund

docs/dev/engines/offline/nosql-engines.rst

@@ -6,16 +6,21 @@ NoSQL databases
 
 .. sidebar:: further read
 
-   - `NoSQL database <https://en.wikipedia.org/wiki/NoSQL>`_
+   - `NoSQL databases <https://en.wikipedia.org/wiki/NoSQL>`_
    - `valkey.io <https://valkey.io/>`_
    - `MongoDB <https://www.mongodb.com>`_
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. sidebar:: info
 
    Initial sponsored by `Search and Discovery Fund
    <https://nlnet.nl/discovery>`_ of `NLnet Foundation <https://nlnet.nl/>`_.
 
-The following `NoSQL database`_ are supported:
+The following `NoSQL databases`_ are supported:
 
 - :ref:`engine valkey_server`
 - :ref:`engine mongodb`
@@ -52,7 +57,7 @@ instance.  To switch into the environment (:ref:`searxng-src`) you can use
 Configure the engines
 =====================
 
-`NoSQL database`_ are used for storing arbitrary data without first defining
+`NoSQL databases`_ are used for storing arbitrary data without first defining
 their structure.
 
 
@@ -70,13 +75,13 @@ Valkey Server
    - :origin:`valkey_server.py <searx/engines/valkey_server.py>`
 
 .. automodule:: searx.engines.valkey_server
-   :members:
+  :members:
 
 
 .. _engine mongodb:
 
-MongoDB / PyMongo
+MongoDB
------------------
+-------
 
 .. _pymongo: https://github.com/mongodb/mongo-python-driver#installation
 
@@ -88,4 +93,4 @@ MongoDB / PyMongo
 
 
 .. automodule:: searx.engines.mongodb
-   :members:
+  :members:

docs/dev/engines/offline/search-indexer-engines.rst

@@ -7,6 +7,11 @@ Local Search APIs
    - `Comparison to alternatives
      <https://docs.meilisearch.com/learn/what_is_meilisearch/comparison_to_alternatives.html>`_
 
+.. contents::
+   :depth: 1
+   :local:
+   :backlinks: entry
+
 .. sidebar:: info
 
    Initial sponsored by `Search and Discovery Fund
@@ -32,8 +37,8 @@ in section :ref:`private engines`.
 
 .. _engine meilisearch:
 
-MeiliSearch Engine
+MeiliSearch
-==================
+===========
 
 .. automodule:: searx.engines.meilisearch
   :members:
@@ -41,16 +46,17 @@ MeiliSearch Engine
 
 .. _engine elasticsearch:
 
-Elasticsearch Engine
+Elasticsearch
-====================
+=============
 
 .. automodule:: searx.engines.elasticsearch
   :members:
 
 .. _engine solr:
 
-Solr Engine
+Solr
-===========
+====
 
 .. automodule:: searx.engines.solr
   :members:
+

docs/dev/engines/offline/sql-engines.rst

@@ -10,6 +10,11 @@ SQL Engines
    - `PostgreSQL <https://www.postgresql.org>`_
    - `MySQL <https://www.mysql.com>`_
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. sidebar:: info
 
    Initial sponsored by `Search and Discovery Fund

docs/dev/engines/online/500px.rst

@@ -1,8 +0,0 @@
-.. _500px engine:
-
-=====
-500px
-=====
-
-.. automodule:: searx.engines.500px
-   :members:

docs/dev/engines/online/adobe_stock.rst

@@ -4,5 +4,10 @@
 Adobe Stock
 ===========
 
+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.adobe_stock
    :members:

docs/dev/engines/online/alpinelinux.rst

@@ -4,5 +4,10 @@
 Alpine Linux Packages
 =====================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.alpinelinux
    :members:

docs/dev/engines/online/annas_archive.rst

@@ -4,5 +4,10 @@
 Anna's Archive
 ==============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.annas_archive
    :members:

docs/dev/engines/online/archlinux.rst

@@ -4,6 +4,11 @@
 Arch Linux
 ==========
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.archlinux
   :members:
 

docs/dev/engines/online/bing.rst

@@ -4,6 +4,12 @@
 Bing Engines
 ============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _bing web engine:
 
 Bing WEB

docs/dev/engines/online/bpb.rst

@@ -4,5 +4,10 @@
 Bpb
 ===
 
+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.bpb
   :members:

docs/dev/engines/online/brave.rst

@@ -1,27 +1,13 @@
+.. _brave engine:
+
 =============
 Brave Engines
 =============
 
-Brave offers two different engines for SearXNG:
+.. contents:: Contents
-
+   :depth: 2
-1. The standard engine (``brave``) uses the web interface.
+   :local:
-2. The API engine (``braveapi``) uses the official REST API.
+   :backlinks: entry
-
-.. _brave engine:
-
-Brave Standard Engine
----------------------
 
 .. automodule:: searx.engines.brave
-   :members:
+  :members:
-
-.. _braveapi engine:
-
-Brave API Engine
-----------------
-
-.. automodule:: searx.engines.braveapi
-   :members:
-
-The API engine requires an API key from Brave. This can be obtained from the
-`API Dashboard <https://api-dashboard.search.brave.com/>`_.

docs/dev/engines/online/bt4g.rst

@@ -4,6 +4,11 @@
 BT4G
 ====
 
+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.bt4g
   :members:
 

docs/dev/engines/online/cara.rst

@@ -1,8 +0,0 @@
-.. _cara engine:
-
-===========
-Cara Images
-===========
-
-.. automodule:: searx.engines.cara
-   :members:

docs/dev/engines/online/core.rst

@@ -4,5 +4,10 @@
 CORE
 ====
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.core
    :members:

docs/dev/engines/online/dailymotion.rst

@@ -4,5 +4,10 @@
 Dailymotion
 ===========
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.dailymotion
   :members:

docs/dev/engines/online/duckduckgo.rst

@@ -4,6 +4,11 @@
 DuckDuckGo Engines
 ==================
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.duckduckgo
    :members:
 

docs/dev/engines/online/exaapi.rst

@@ -1,8 +0,0 @@
-.. _exaapi engine:
-
-==============
-Exa API Engine
-==============
-
-.. automodule:: searx.engines.exaapi
-   :members:

docs/dev/engines/online/google.rst

@@ -4,6 +4,12 @@
 Google Engines
 ==============
 
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+
 .. _google API:
 
 Google API

docs/dev/engines/online/kagi.rst

@@ -1,9 +0,0 @@
-.. _kagi engines:
-
-============
-Kagi Engines
-============
-
-.. automodule:: searx.engines.kagi
-   :members:
-

docs/dev/engines/online/lemmy.rst

@@ -4,5 +4,10 @@
 Lemmy
 =====
 
+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.lemmy
    :members:

docs/dev/engines/online/loc.rst

@@ -4,5 +4,10 @@
 Library of Congress
 ===================
 
+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.loc
   :members:

docs/dev/engines/online/mastodon.rst

@@ -4,5 +4,10 @@
 Mastodon
 ========
 
+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.mastodon
   :members:

docs/dev/engines/online/moviepilot.rst

@@ -4,5 +4,10 @@
 Moviepilot
 ==========
 
+.. contents:: Contents
+   :depth: 2
+   :local:
+   :backlinks: entry
+
 .. automodule:: searx.engines.moviepilot
    :members: