2020-03-02 18:00:19 +00:00
.. _installation docker:
===================
Docker installation
===================
.. contents :: Contents
:depth: 2
:local:
:backlinks: entry
2020-07-22 12:58:04 +00:00
----
2021-04-24 06:53:12 +00:00
Docker image searxng/searxng
============================
2020-07-22 12:58:04 +00:00
2021-04-24 06:53:12 +00:00
The docker image is `searxng/searxng <https://hub.docker.com/r/searxng/searxng> `_ (based on `github.com/searxng/searxng <https://github.com/searxng/searxng> `_ ).
2020-07-22 12:58:04 +00:00
Make sure you have `installed Docker <https://docs.docker.com/get-docker/> `_ . For instance, you can deploy a local instance:
2020-03-02 18:00:19 +00:00
.. code :: sh
2020-07-22 12:58:04 +00:00
export PORT=80
2021-04-24 06:53:12 +00:00
docker pull searxng/searxng
docker run --rm -d -v ${PWD}/searx:/etc/searx -p $PORT:8080 -e BASE_URL=http://localhost:$PORT/ searxng/searxng
2020-03-02 18:00:19 +00:00
Go to `` http://localhost:$PORT `` .
2020-07-22 12:58:04 +00:00
Inside `` ${PWD}/searx `` , you will find `` settings.yml `` and `` uwsgi.ini `` .
You can modify these files according to your needs and restart the Docker image.
Command line
------------
.. code :: sh
2021-04-24 06:53:12 +00:00
docker run --rm -it searxng/searxng -h
2020-07-22 12:58:04 +00:00
2020-09-09 08:28:17 +00:00
.. program-output :: ../dockerfiles/docker-entrypoint.sh help
2020-07-22 12:58:04 +00:00
Build the image
---------------
2021-04-24 06:53:12 +00:00
It's also possible to build SearXNG from the embedded Dockerfile.
2020-03-02 18:00:19 +00:00
.. code :: sh
2021-04-24 06:53:12 +00:00
git clone https://github.com/searxng/searxng.git
2020-03-02 18:00:19 +00:00
cd searx
2021-04-18 10:12:03 +00:00
make docker.build
2020-07-22 12:58:04 +00:00
Public instance
===============
If you intend to create a public instance using Docker, see https://github.com/searx/searx-docker
