How to add your instance to the list?

Create a new issue here: https://github.com/searxng/searx-instances/issues/new/choose

For SearXNG instance operators

Create an issue to add / remove / edit a SearXNG instance on https://searx.space/
If you add a new instance, allow the IPs of check.searx.space to access your instance. It will checks your instance periodically (source code). The results are displayed on https://searx.space/
Wait for a reviewer to actually change searxstats/instances.yml

For reviewers

Add a new instance to the public list

create a virtualenv, and then install searxinstances:

python -m pip install .[update]

then searxinstances can help to edit instances.yml :


usage: searxinstances [-h] [--github-issues [GITHUB_ISSUE_LIST [GITHUB_ISSUE_LIST ...]]] [--add [ADD_INSTANCES [ADD_INSTANCES ...]]] [--delete [DELETE_INSTANCES [DELETE_INSTANCES ...]]] [--edit [EDIT_INSTANCES [EDIT_INSTANCES ...]]]

Update the instance list according to the github issues.

optional arguments: -h, --help show this help message and exit --github-issues [GITHUB_ISSUE_LIST [GITHUB_ISSUE_LIST ...]] Github issue number to process, by default all --add [ADD_INSTANCES [ADD_INSTANCES ...]] Add instance(s) --delete [DELETE_INSTANCES [DELETE_INSTANCES ...]] Delete instance(s) --edit [EDIT_INSTANCES [EDIT_INSTANCES ...]] Edit instance(s)


Or if you don't want to use virtualenv:

1. `pip install .[update]`
2. `python -m searxinstances.update`

The tool :
* is only an helper. instances.yml can be edited directly.
* shows the default editor to only edit one instance at a time.
* once the user quits the editor, the script checks everything is okay, if not it goes back to the editor with the error added at the end of the buffer.
* if everything is okay, the script modifies the instances.yml file.
* then it creates a commit.
* The ```--github-issues``` options reads the [github issues](https://github.com/searxng/searx-instances/issues).

---

An example what is shown in the default editor:

https://nibblehole.com: {}

nibblehole.com

Close https://github.com/searxng/searx-instances/issues/2

From @dalf

> The above text is the commit message

> Delete the whole buffer to cancel the request

> -- MESSAGE -----------------------

> See https://github.com/searxng/ ...



Here is it possible to modify the yaml, the commit message and validate or delete the whole buffer to cancel.

### Add a previously submitted instance

Was discussed in https://github.com/searxng/searx-instances/discussions/150

1. Look in the commit history if the instance was already added and got removed due to errors or bad uptime.
   The bot may help you with that.
2. If the instance was previously removed only once for bad uptime or errors then add the domain on https://github.com/searxng/searx-instances-uptime/blob/master/.upptimerc-custom.yml.
  But if the instance was removed multiple times, do not add the instance or make an exception in exceptional cases.
3. Add the label `wait-1-week`.
4. If the uptime is more than 95% (8 hours) after 1 week the instance can be normally added back and remove it from the custom file.  
   If not do not add the instance.

searxng / searx-instances

readme