Installation on RHEL 7 CentOS 7

Elias Ojala edited this page Nov 5, 2018 · 8 revisions

Step by step installation for RHEL7 / CentOS 7, based on the official installation instructions on this wiki.

Basic installation

You need EPEL repo for zlib-devel mod_proxy_uwsgi uwsgi-plugin-python

Install EPEL :

yum install epel-release && yum update

Install packages :

yum install gcc zlib-devel git openssl-devel libffi-devel python-babel python-virtualenv libxslt-devel

Install searx :

cd /usr/local
git clone
useradd searx -d /usr/local/searx
chown searx:searx -R /usr/local/searx

Install dependencies in a virtualenv :

su - searx
cd /usr/local/searx
virtualenv searx-ve
. ./searx-ve/bin/activate
pip install --upgrade pip
pip install --upgrade setuptools
./ update_packages


sed -i -e "s/ultrasecretkey/`openssl rand -hex 16`/g" searx/settings.yml

Edit searx/settings.yml if necessary.


Start searx :

python searx/

Go to http://localhost:8888

If everything works fine, disable the debug option in settings.yml:

sed -i -e "s/debug : True/debug : False/g" searx/settings.yml

At this point searx is not demonized ; uwsgi allows this.

You can exit the virtualenv and the searx user bash (enter exit).


Install packages :

yum install uwsgi uwsgi-plugin-python

Create the configuration file /etc/uwsgi.d/searx.ini with this content :

# Who will run the code
uid = searx
gid = searx

# disable logging for privacy
disable-logging = true

# Number of workers (usually CPU count)
workers = 4
socket =

# The right granted on the created socket
chmod-socket = 666

# Plugin to use and interpretor config
single-interpreter = true
master = true
plugin = python
lazy-apps = true
enable-threads = true

# Module to import
module = searx.webapp

# Virtualenv and python path
virtualenv = /usr/local/searx/searx-ve/
pythonpath = /usr/local/searx/
chdir = /usr/local/searx/searx/

Change ownership of the new config file :

chown uwsgi:uwsgi /etc/uwsgi.d/searx.ini

Create PID directory :

mkdir /run/uwsgi
chown searx:searx -R /run/uwsgi

Activate the uwsgi application and restart :

systemctl enable uwsgi
systemctl start uwsgi

Web server

with nginx

Install NGINX if not already installed :

yum install nginx

Hosted at /

Create the configuration file /etc/nginx/conf.d/searx.conf with this content:

server {
    listen 80;
    listen [::]:80;


    location / {
            include uwsgi_params;

NOTE: If searx is the only site you are hosting on this server (ideally) then you may need to disable the NGINX default site. Delete or comment out the server section from /etc/nginx/nginx.conf

Restart service:

systemctl restart nginx
systemctl restart uwsgi

Hosted from subdirectory (/searx)

Add this configuration in the server config file /etc/nginx/nginx.conf :

location = /searx { rewrite ^ /searx/; }
location /searx {
        try_files $uri @searx;
location @searx {
        uwsgi_param SCRIPT_NAME /searx;
        include uwsgi_params;
        uwsgi_modifier1 30;

Enable base_url in searx/settings.yml

base_url : http://your.domain.tld/searx/

Restart service:

systemctl restart nginx
systemctl restart uwsgi

Disable logs

For better privacy you can disable nginx logs about searx. Below uwsgi_pass in /etc/nginx/conf.d/searx.conf or /etc/nginx/nginx.conf add

access_log /dev/null;
error_log /dev/null;

Restart service:

sudo service nginx restart

with apache

Add and enable wsgi mod :

yum install mod_proxy_uwsgi
echo "LoadModule proxy_uwsgi_module modules/" > /etc/httpd/conf.modules.d/00-uwsgi.conf

Create a proxy configuration file :

echo "ProxyPass / uwsgi://" > /etc/httpd/conf.d/searx.conf

Note that if your instance of searx is not at the root, you should change ProxyPass / by the location of your instance, like ProxyPass /searx.

Restart Apache :

systemctl restart httpd

If you have SELinux enabled, you must allow httpd to allow network connect :

setsebool -P httpd_can_network_connect 1

How to update (not tested)

cd /usr/local/searx
su - searx
. ./searx-ve/bin/activate
git stash
git pull origin master
git stash apply
./ update_packages
systemctl restart uwsgi
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.