The Pi-hole FTL engine
Go to file
Adam Warner dbd4a696af
Merge pull request #853 from pi-hole/release/v5.2
Pi-hole FTL v5.2
2020-08-09 22:09:43 +01:00
.circleci Add a build script for users. FTL can be build by simply running "./build.sh" 2020-05-26 22:30:00 +02:00
.github Add .github/PULL_REQUEST_TEMPLATE.md (#24) 2017-05-01 14:44:03 +02:00
src Create and use a temporary copy of the domain string during the analysis 2020-08-05 13:26:21 +02:00
test Merge pull request #832 from pi-hole/new/cname_inspection_logging 2020-07-23 06:19:17 +02:00
tools Merge pull request #739 from MichaIng/patch-1 2020-05-25 21:27:33 +02:00
.gitignore Tweak revert commit. We should add the port after configuring it and independtly from opening IPv4 and/or IPv6 sockets. Also, we cannot delete the port in close_telnet_port() as this function is called by TCP workers since v5.1 so we'd loose the port file when the first TCP query comes in. 2020-07-17 10:06:48 +02: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 Lower needed cmake version to 2.8.12 2020-05-26 21:18:56 +02: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 Reduce README.md 2020-05-25 11:00:28 -07:00
build.sh Improve build.sh script. Add "install" and "clean" targets. Also ensure successive builds are possible to speed up the entire process. 2020-05-27 19:04:06 +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.