neon_arch commited on
Commit
74d64ce
β€’
1 Parent(s): a536256

πŸ“ docs: explain the newly added config options (#265)

Browse files
Files changed (1) hide show
  1. docs/configuration.md +18 -1
docs/configuration.md CHANGED
@@ -15,6 +15,7 @@ Some of the configuration options provided in the file are stated below. These a
15
 
16
  - General
17
  - Server
 
18
  - Website
19
  - Cache
20
  - Search Engines
@@ -29,8 +30,21 @@ Some of the configuration options provided in the file are stated below. These a
29
 
30
  - **port:** Port number on which server should be launched.
31
  - **binding_ip_addr:** IP address on the which server should be launched.
32
- - **production_use:** Whether to use production mode or not (in other words this option should be used if it is to be used to host it on the server to provide a service to a large number of users). If production_use is set to true. There will be a random delay before sending the request to the search engines, this is to prevent DDoSing the upstream search engines from a large number of simultaneous requests. This is newly added option and hence is only available in the **edge version**.
33
  - **request_timeout:** Timeout for the search requests sent to the upstream search engines to be fetched (value in seconds).
 
 
 
 
 
 
 
 
 
 
 
 
 
34
 
35
  ## Website
36
 
@@ -61,6 +75,9 @@ Some of the configuration options provided in the file are stated below. These a
61
 
62
  - **redis_url:** Redis connection url address on which the client should connect on.
63
 
 
 
 
64
  ## Search Engines
65
 
66
  - **upstream_search_engines:** Select from the different upstream search engines from which the results should be fetched.
 
15
 
16
  - General
17
  - Server
18
+ - Search
19
  - Website
20
  - Cache
21
  - Search Engines
 
30
 
31
  - **port:** Port number on which server should be launched.
32
  - **binding_ip_addr:** IP address on the which server should be launched.
33
+ - **production_use:** Whether to use production mode or not (in other words this option should be used if it is to be used to host it on the server to provide a service to a large number of users). If production_use is set to true. There will be a random delay before sending the request to the search engines, this is to prevent DDoSing the upstream search engines from a large number of simultaneous requests.
34
  - **request_timeout:** Timeout for the search requests sent to the upstream search engines to be fetched (value in seconds).
35
+ - **rate_limiter:** The configuration option to configure rate limiting on the search engine website.
36
+
37
+ ## Search
38
+
39
+ - **safe_search:** This option is used to configure the search filtering based on different safe search levels. (value a number between 0 to 4)
40
+
41
+ > This option provides 4 levels of search filtering:
42
+ >
43
+ > - Level 0 - With this level no search filtering occurs.
44
+ > - Level 1 - With this level some search filtering occurs.
45
+ > - Level 2 - With this level the upstream search engines are restricted to send sensitive contents like NSFW search results, etc.
46
+ > - Level 3 - With this level the regex based filter lists is used alongside level 2 to filter more search results that have slipped in or custom results that needs to be filtered using the filter lists.
47
+ > - Level 4 - This level is similar to level 3 except in this level the regex based filter lists are used to disallow users to search sensitive or disallowed content. This level could be useful if you are parent or someone who wants to completely disallow their kids or yourself from watching sensitive content.
48
 
49
  ## Website
50
 
 
75
 
76
  - **redis_url:** Redis connection url address on which the client should connect on.
77
 
78
+ > **Note**
79
+ > This option can be commented out if you have compiled the app without the `redis-cache` feature. For more information, See [**building**](./building.md).
80
+
81
  ## Search Engines
82
 
83
  - **upstream_search_engines:** Select from the different upstream search engines from which the results should be fetched.