The Pi-hole FTL engine
Go to file
Adam Warner 086adf90f1
Add basic devcontainer.json based on ftl-build for x86_64 arch, with a few helpful extensions.
Signed-off-by: Adam Warner <me@adamwarner.co.uk>
2022-07-25 18:05:01 +01:00
.devcontainer Add basic devcontainer.json based on ftl-build for x86_64 arch, with a few helpful extensions. 2022-07-25 18:05:01 +01:00
.github Fix ownership of repository to avoid failure because of "fatal: detected dubious ownership in repository at '/__w/FTL/FTL'" even though "set-safe-directory: true" is set in the Github checkout action 2022-07-25 18:02:22 +02:00
src Merge pull request #1386 from pi-hole/tweak/DELAY_UPTIME 2022-07-25 15:51:14 +02:00
test Change default log file path to /var/log/pihole/FTL.log 2022-07-03 18:36:39 +02:00
tools Fix outdated link to Wireshark manufacturer database 2022-05-21 22:55:33 +02:00
.codespellignore Fix some spellings, ignore others 2022-04-22 18:26:31 +01:00
.gitignore Add basic devcontainer.json based on ftl-build for x86_64 arch, with a few helpful extensions. 2022-07-25 18:05:01 +01:00
.gitmodules Removed bats submodules 2019-06-08 18:35:10 +02:00
.pullapprove.yml Add PullApprove settings file (copied from core repo) (#23) 2017-05-01 14:47:46 +02:00
CMakeLists.txt Update dnsmasq version 2022-02-08 20:29:23 +01:00
FTLtest.sh Use /run instead of /var/run for FTL runtime files 2020-05-01 12:41:33 +02:00
LICENSE Improve formating 2017-06-03 15:05:41 +02:00
README.md Use dropshadowed logo 2021-02-18 19:53:48 -08:00
build.sh Use cmake --install to avoid second compilation when installing 2022-07-03 12:36:08 +02:00

README.md

Pi-hole
Network-wide ad blocking via your own Linux hardware

FTLDNS

FTLDNS (pihole-FTL) provides an interactive API and also generates statistics for Pi-hole®'s Web interface.

  • Fast: stats are read directly from memory by coupling our codebase closely with dnsmasq
  • Versatile: upstream changes to dnsmasq can quickly be merged in without much conflict
  • Lightweight: runs smoothly with minimal hardware and software requirements such as Raspberry Pi Zero
  • Interactive: our API can be used to interface with your projects
  • Insightful: stats normally reserved inside of dnsmasq are made available so you can see what's really happening on your network

Official documentation

The official FTLDNS documentation can be found here.

Installation

FTLDNS (pihole-FTL) is installed by default when you choose to enable the Web interface when installing Pi-hole.

IMPORTANT!

FTLDNS will disable any existing installations of dnsmasq. This is because FTLDNS is dnsmasq + Pi-hole's code, so both cannot run simultaneously.