searxng/docs/dev/quickstart.rst

Development Quickstart

SearXNG loves developers, just clone and start hacking. All the rest is done for you simply by using make <makefile>.

git clone https://github.com/searxng/searxng.git searx

Here is how a minimal workflow looks like:

1. start hacking
2. run your code: make run
3. test your code: make test

If you think at some point something fails, go back to start. Otherwise, choose a meaningful commit message and we are happy to receive your pull request. To not end in wild west we have some directives, please pay attention to our "how to contribute" guideline.

If you implement themes, you will need to compile styles and JavaScript before run.

make themes.all

Don't forget to install npm first.

Ubuntu / debian

sudo -H apt-get install npm

Arch Linux

sudo -H pacman -S npm

Fedora / RHEL

sudo -H dnf install npm

If you finished your tests you can start to commit your changes. To separate the changed code from the build products first run:

make static.build.restore

This will restore the old build products and only your changes of the code remain in the working tree which can now be added & commited. When all sources are commited, you can commit the build products simply by:

make static.build.commit

Commiting the build products should be the last step, just before you send us your PR. There is also a make target to rewind this last build commit:

make static.build.drop