filehunter

Simple, fast, open source file search engine. Designed to be local file search engine for places where multiple documents are stored on multiple hosts with multiple directories.

Core features

Blazing fast search through your files in all indexes
Parsing documents and index content for full text search
Multiple backends supported, search files available on local filesystem, WebDAV, S3, FTP, NFS
Nice and fast React based frontend
Offline indexes - reindex directory and search for files even on umounted drives
Open Source, self-hosted solution, easy to start using single file
API driven architecture - every operation you can perform using REST API

Get started

Java 11 or higher is required to run FileHunter
Download the latest version from releases in Github
Create separate directory where you put jar file
Run java -jar filehunter-<version>.jar
Open in browser http://<HOST_IP>:8034
Create new index using GUI with name and directory

Screenshot

Have a look on web based GUI

Configuration variables

Filehunter might be configured using env variables. Lists of variables is available below. You can set this value -Dvar.name=var.value -Dvar2.name=var2.value for example java -Dfilehunter.storage.directory=/tmp/myindexdirectory -jar filehunter-<version>.jar

var	description	default value
filehunter.storage.directory	Directory for index data	`./filehunterstorage`
quarkus.http.host	Host used by app	`0.0.0.0`
quarkus.http.port	Port used by app	`8034`

Support

If you need additional support or dedicated component/integration/feature I'm open to develop it. Reach me at hello@ogefest.com

FAQ

Is Filehunter ready and steady?
- Nope, right now is in early development stage and probably has some bugs which might make it hard to use
I found a bug, where I can report it?
- The easiest way is to open issue using Github
I've added a new index but when I try to search for something I got empty results, what is wrong?
- Is this directory was indexed? Filehunter needs a few seconds or minutes or hours (depends on how many files are in the directory) after the index was created to be able to search for something. Check the date in indexes when directory reindex was finished.
How long may take to reindex whole directory?
- It depends on how fast is access to your storage. For example, NMVe drive and directory with 120k files with size of 5GB first reindex take about 30 seconds. 800k files with size of 1 TB over NAS storage take 30 minutes for first reindex
How to change host and/or port?
- Run with parameters java -Dquarkus.http.port=8888 -Dquarkus.http.host=127.0.0.1 -jar filehunter-<version>.jar You can change all parameters from this list
Files in my directory changed frequently, when new files will be available to search?
- It depends on index configuration. Check option File structure interval in index configuration

Ogefest / filehunter