Skip to content
Create a searx instance, battery included (use Docker)
Branch: master
Clone or download


Create a new searx instance in five minutes using Docker (see )

This is a work in progress, the bot protection is basic and not battle tested, and later on, may change.

What is included ?

Name Description Docker image Dockerfile
Caddy Reverse proxy (create a LetsEncrypt certificate automatically) abiosoft/caddy:1.0.1-no-stats Dockerfile
Filtron Filtering reverse HTTP proxy, bot and abuse protection dalf/filtron:latest See asciimoo/filtron#4
Searx searx by itself searx/searx:latest Dockerfile
Morty Privacy aware web content sanitizer proxy as a service. dalf/morty:latest Dockerfile
Searx-checker Check which engines return results of the instance.
JSON result available at
Automatically updated every 24h
searx/searx-checker:latest Dockerfile

How to use it

cd /usr/local
git clone
cd searx-docker
  • Edit the .env file according to your need
  • Check everything is working: ./,
  • cp searx-docker.service.template searx-docker.service
  • edit the content of WorkingDirectory in the searx-docker.service file (only if the installation path is different from /usr/local/searx-docker)
  • Install the systemd unit :
systemctl enable $(pwd)/searx-docker.service
systemctl start searx-docker.service

Note on the image proxy feature

The searx image proxy is activated by default using Morty.

The default Content-Security-Policy allow the browser to access to {SEARX_HOSTNAME} and https://*;.

If some users wants to disable the image proxy, you have to modify ./Caddyfile. Replace the img-src 'self' data: https://*; by img-src * data:;

Custom docker-compose.yaml

Do not modify docker-compose.yaml otherwise you won't be able to update easily from the git repository.

It is possible to the extend feature of docker-compose :

  • stop the service : systemctl stop searx-docker.service
  • create a new docker-compose-extend.yaml, check with
  • update searx-docker.service (see SEARX_DOCKERCOMPOSEFILE)
  • restart the servie : systemctl restart searx-docker.service

Multi Architecture Docker images

For now only the amd64 platform is supported.

How to update ?

Check the content of

You can’t perform that action at this time.