filehunter
filehunter copied to clipboard
Simple, fast, open source file search engine
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 [email protected]
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>.jarYou can change all parameters from this list
- Run with parameters
- Files in my directory changed frequently, when new files will be available to search?
- It depends on index configuration. Check option
File structure intervalin index configuration
- It depends on index configuration. Check option