| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | =============================================================
 | 
					
						
							|  |  |  | Searx admin interface
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | =============================================================
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | .. _searx-admin: https://github.com/kvch/searx-admin#searx-admin
 | 
					
						
							|  |  |  | .. _NLnet Foundation: https://nlnet.nl/
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  |   manage your instance from your browser
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | .. sidebar:: Installation
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  |    Installation guide can be found in the repository of searx-admin_.
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | One of the biggest advantages of searx is being extremely customizable. But at
 | 
					
						
							|  |  |  | first it can be daunting to newcomers.  A barrier of taking advantage of this
 | 
					
						
							|  |  |  | feature is our ugly settings file which is sometimes hard to understand and
 | 
					
						
							|  |  |  | edit.
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | To make self-hosting searx more accessible a new tool is introduced, called
 | 
					
						
							|  |  |  | ``searx-admin``.  It is a web application which is capable of managing your
 | 
					
						
							|  |  |  | instance and manipulating its settings via a web UI.  It aims to replace editing
 | 
					
						
							|  |  |  | of ``settings.yml`` for less experienced administrators or people who prefer
 | 
					
						
							|  |  |  | graphical admin interfaces.
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | .. figure:: searx-admin-engines.png
 | 
					
						
							|  |  |  |    :alt: Screenshot of engine list
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  |    Configuration page of engines
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | Since ``searx-admin`` acts as a supervisor for searx, we have decided to
 | 
					
						
							|  |  |  | implement it as a standalone tool instead of part of searx.  Another reason for
 | 
					
						
							|  |  |  | making it a standalone tool is that the codebase and dependencies of searx
 | 
					
						
							|  |  |  | should not grow because of a fully optional feature, which does not affect
 | 
					
						
							|  |  |  | existing instances.
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | Acknowledgements
 | 
					
						
							|  |  |  | ================
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-12-12 19:20:56 +01:00
										 |  |  | This development was sponsored by `NLnet Foundation`_.
 | 
					
						
							| 
									
										
										
										
											2017-08-22 21:30:00 +02:00
										 |  |  | 
 | 
					
						
							|  |  |  | | Happy hacking.
 | 
					
						
							|  |  |  | | kvch // 2017.08.22 21:25
 |