Configuration File (config.ini)

This page documents all configuration variables available in config.ini, including their purpose, possible values, and default settings.

[Server] Configuration

Variable	Description	Default Value	Possible Values
Port	Port number for the application server	5000	Any valid port number
Domain	Domain address of the server	localhost	Any valid domain name or IP address
LogLevel	Logging level for the application	1	0 (Silent), 1 (Errors), 2 (Warnings), 3 (Info), 4 (Debug)
HashSecret	Secret key used for generating HMAC-SHA256 hashes of links to prevent predictable URLs and unauthorized crawling. If not set, a plain SHA256 hash is used instead.	Empty	Empty or any random string (recommended 32-64 chars)

Notes:

• LogLevel = 4 will enable /debug endpoint for debugging.
• Don't use LogLevel = 4 in prod, as it prints identifiable information in logs.

[Features] Toggles

Variable	Description	Default Value	Possible Values
Crawler	Enable MetaSearch crawling from other search engines	true	true / false
FilterEngine	Enable the ad/malware filter engine	false	true / false
Website	Enable website hosting feature	true	true / false
MetaProxy	Use proxies for MetaSearch crawling	false	true / false
SelfTest	Enable startup and cooldown self-tests for engines	true	true / false
RamCache	Enable caching in RAM	true	true / false
DriveCache	Enable caching on disk	false	true / false
CachePreferred	Cache preferred/healthy engine selections on disk	true	true / false
FastBoot	Run supported engine initialization in the background	true	true / false
ValkeyCache	Enable caching to Valkey, enabling automatically disables RAM cache	false	true / false
Nodes	Enable node/distributed features, experimental builds only	false	true / false
Indexer	Enable web crawling and indexing, experimental builds only	false	true / false
CrawlerProxy	Use proxies for general web crawling and indexing, experimental builds only	false	true / false

[Proxies] Configuration

Variable	Description	Default Value	Possible Values
MetaProxyStrict	Try without proxy first, use proxy if local search fails	false	true / false
MetaProxies	List of proxies to use for MetaSearch crawling	Empty	Comma-separated proxies
MetaProxyRetry	Number of retry attempts for MetaProxy requests	3	Any positive integer
CrawlerProxyStrict	Try without proxy first, use proxy if local search fails, experimental builds only	false	true / false
CrawlerProxies	List of proxies to use for web crawling and indexing, experimental builds only	Empty	Comma-separated proxies
CrawlerProxyRetry	Number of retry attempts for CrawlerProxy requests, experimental builds only	1	Any positive integer

Notes:

• Proxies use the SOCKS5 protocol.
• Proxies must be specified as a comma-separated list, don't use comma with space behind it.
• Each proxy should be in the format:
  • ADDRESS:PORT
  • ADDRESS:PORT:USER:PASSWORD
• Example:
  • proxy1.example.com:8080:user1:pass1,proxy2.example.com:8080

[MetaSearch] Configuration

Key	Description	Default Value	Possible Values
Text	A comma-separated list of text search engines in the exact order to query. Engines not listed are skipped.	Google,Brave,DuckDuckGo,Mojeek	Google, LibreX, Brave, DuckDuckGo, Mojeek
Image	A comma-separated list of image search engines in the exact order to query. Engines not listed are skipped.	Qwant,Bing,DeviantArt	Qwant, Bing, DeviantArt
Files	A comma-separated list of file/torrent search engines to enable (in any order).	TorrentGalaxy,ThePirateBay,Nyaa	TorrentGalaxy, ThePirateBay, Nyaa
Video	A comma-separated list of Piped instances to use for video searching. The fastest responding instance is preferred.	api.piped.yt,pipedapi.moomoo.me,...	Any valid Piped instance domain
LibreXInstances	A comma-separated list of LibreX / LibreX-Y endpoints. All responding instances are queried and aggregated.	librex.antopie.org	Any valid LibreX domain
Concurrent	Limits how many search engines are queried in parallel per request. Prevents engine spam and global blocks.	2	Positive number
TimeoutSeconds	Maximum time to wait for the first non-empty result from any engine before aborting the request.	5	Positive number
Prefetch	Enables background prefetching of next/previous result pages after a successful search.	false	true / false
PrefetchDelay	Delay before prefetching starts, allowing the main request to finish first.	280ms	Duration like 100ms, 1s, 2s

[Indexer] Crawling and Indexing

Variable	Description	Default Value	Possible Values
ConcurrentStandardCrawlers	Number of standard crawlers running at once	12	Positive number
ConcurrentChromeCrawlers	Number of Chrome-based crawlers running	4	Positive number
CrawlingInterval	Time between refreshing crawled results	24h	Duration like 1h, 30m, 2h45m
MaxPagesPerDomain	Maximum pages to crawl per domain	10	Positive number
IndexBatchSize	Number of pages to index in one batch	50	Positive number

Please note that self-indexing/crawling is marked as experimental and is not available in normal builds, as it is not finished and will likely be deprecated.

Cache Configuration

[ValkeyCache]

Variable	Description	Default Value	Possible Values
Address	IP/hostname and port of your Valkey instance. Valkey API v9 expected.	localhost:6379	IP:port or hostname:port
Password	Password for your Valkey instance, may be empty if auth is disabled.	Empty	Any string or Empty
DB	Logical database index to use. In standalone mode supports multiple DBs, in cluster mode only DB 0 is valid.	0	0-15 (standalone, depending on server databases), 0 (cluster)

Notes:

• Enabling Valkey Cache in the [Features] section will automatically disable RAM Cache. This prevents redundant in-memory caching.
• It is recommended to run with Valkey V9.

[RamCache]

Variable	Description	Default Value	Possible Values
Duration	Time to store results in RAM	6h	Duration like 1h, 30m, 2h45m
MaxUsage	Maximum RAM usage	90%	Percentage (%) or size (e.g., 2GiB)

[DriveCache]

Variable	Description	Default Value	Possible Values
Duration	Time to store results on disk	48h	Duration like 1h, 30m, 2h45m
MaxUsage	Maximum disk usage	90%	Percentage (%) or size (e.g., 10GiB)
Path	Path to the disk cache directory	./cache	Any valid file path

[FilterLists] Configuration

Controls which public blocklists are downloaded and used by the URL filter engine.

Variable	Description	Default Value	Possible Values
RefreshInterval	How often downloaded filter lists should be refreshed from their source URL. Cached files newer than this are reused.	168h0m0s	Duration like 2h45m, 24h, 168h
Ads	Comma-separated list of ad-blocking filter list URLs.	https://easylist.to/easylist/easylist.txt,https://blocklistproject.github.io/Lists/adguard/ads-ags.txt,https://small.oisd.nl,https://weforge.xyz/Spitfire/FilterLists/raw/branch/main/ads.txt	Comma-separated URLs
Tracking	Comma-separated list of privacy and tracking protection filter list URLs.	https://easylist.to/easylist/easyprivacy.txt,https://blocklistproject.github.io/Lists/adguard/tracking-ags.txt	Comma-separated URLs
Scam	Comma-separated list of phishing, fraud, and scam protection filter list URLs.	https://blocklistproject.github.io/Lists/adguard/phishing-ags.txt,https://blocklistproject.github.io/Lists/adguard/fraud-ags.txt,https://blocklistproject.github.io/Lists/adguard/scam-ags.txt,https://phishing.army/download/phishing_army_blocklist_extended.txt	Comma-separated URLs
Malware	Comma-separated list of malware and ransomware protection filter list URLs.	https://blocklistproject.github.io/Lists/adguard/malware-ags.txt,https://blocklistproject.github.io/Lists/adguard/ransomware-ags.txt,https://v.firebog.net/hosts/RPiList-Malware.txt	Comma-separated URLs
NSFW	Comma-separated list of adult-content filter list URLs.	https://blocklistproject.github.io/Lists/adguard/porn-ags.txt,https://nsfw.oisd.nl	Comma-separated URLs
Gambling	Comma-separated list of gambling-related filter list URLs.	https://blocklistproject.github.io/Lists/adguard/gambling-ags.txt	Comma-separated URLs
Crypto	Comma-separated list of crypto-related filter list URLs.	https://blocklistproject.github.io/Lists/adguard/crypto-ags.txt	Comma-separated URLs