Files
pi-hosted/docs/searxng.md
2022-01-14 17:33:22 +00:00

60 lines
2.1 KiB
Markdown

# Install and Setup instructions for SearxNG
## Introduction
[SearXNG](https://docs.searxng.org/) is a free internet metasearch engine which aggregates results from more than 70 search services. Users are neither tracked nor profiled.
![SearXNG Page](images/searxng_searchExample.png)
## Installation
![SearXNG on Template list](images/searxng_templateApp.png)
Look for `SearXNG` on Template list.
![SearXNG deploy configuration](images/searxng_DeployContainer.png)
For the configuration, correct `BASE_URL` variable with a domain (if using one) or replace `localhost` with the Raspberry Pi's IP.
You can change `INSTANCE_NAME` to anything you want and it's not required.
Once done, click in `Deploy the container`.
## Configuring
Once deployed, you can view and modify all configurations under `/portainer/Files/AppData/Config/searxng/settings.yml`. Visit the [official doc page](https://docs.searxng.org/admin/engines/settings.html) for details on each setting.
The main thing you might want to do is to set:
- `general`
+ `instance_name`: To give a more personal looking
- `search`
+ `languages`: set here any Language you want to use
- server:
+ `port`: DON'T CHANGE, this is set within the container
+ `bind_address`: DON'T CHANGE, this is set within the container
+ `base_url`: DON'T CHANGE, this is set within the container
+ `secret_key`: A random one is generated when deploying, don't need to change
- `ui`
+ `default_theme`: **oscar** or **simple**
+ `theme_args`:
* `oscar_style`: **logicodev**, **logicodev-dark** or **pointhi**
From there, you can scroll down to `engines` and **enable/disable** anyone you want.
## Troubleshooting
### Google "Suspended: too many requests"
Try enabling `use_mobile_ui: true` in google section of `/portainer/Files/AppData/Config/searxng/settings.yml` ([Reference](https://github.com/searxng/searxng/issues/531))
```yaml
- name: google
engine: google
shortcut: go
# see https://searxng.github.io/searxng/src/searx.engines.google.html#module-searx.engines.google
use_mobile_ui: true
# additional_tests:
# android: *test_android
```