Skip to content
BuboTerraePublic

About

Free and open source DNS sinkhole designed to block ads, trackers, malware domains, and unwanted content at the network level.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

Repository files navigation

PITSINKR

Open Source DNS Sinkhole

Beta License MIT PRs Welcome Contributions Welcome

Works on My Machine Tests: Eventually Hopes & Dreams

Go TypeScript React Docker Tailwind CSS SQLite

GitHub Contributors GitHub Last Commit GitHub Open PRs GitHub Forks GitHub Stars

DESCRIPTION

PitSinkr is a free and open source DNS sinkhole designed to block ads, trackers, malware domains, and unwanted content at the network level.

Inspired by Pi-Hole, PitSinkr aims to be a modern, high-performance alternative with improved speed, easier management, and additional features. It runs on your hardware or server and filters DNS requests for your entire network.

CURRENT STATUS

PitSinkr is in very early development stages. Currently it can only read and log DNS traffic. Blocking functionality is not yet implemented. We are actively working to add full sinkholing, blocklists, and more.

You can see your traffic requests in the web dashboard available at localhost:9056 once you start the app.

KEY GOALS

  • Drop-in replacement or better than Pi-Hole
  • Excellent performance even on low-power devices
  • Modern and user-friendly web interface
  • Easy setup and maintenance
  • Strong privacy focus
  • Flexible blocklist management
  • Detailed query statistics and analytics

CURRENT CAPABILITIES

  • Captures and logs DNS queries
  • Basic traffic inspection
  • Multi-platform support (Linux, macOS, Windows - coming soon)

PLANNED FEATURES

  • Full DNS blocking and sinkholing
  • Support for popular blocklists (AdGuard, StevenBlack, etc.)
  • Real-time statistics and graphs
  • Whitelisting and custom rules
  • Automatic blocklist updates
  • DHCP server integration
  • Query caching for better speed
  • API for third-party integrations
  • Docker and standalone installation options

INSTALLATION (Early Stage)

Note: Installation is currently for developers and testers only. This is not recommended for production use at the moment.

  1. Clone the repository
  2. Build the Go backend
  3. Install dependencies for the frontend
  4. Run the DNS listener (requires root/admin privileges)

Detailed setup instructions will be added as the project matures. Docs coming soon

HOW TO TEST

You can currently run PitSinkr to monitor DNS traffic on your network. Configure your router or devices to forward DNS queries to the machine running PitSinkr.

LIMITATIONS

  • No blocking yet (read-only mode only)
  • Dashboard is limited
  • Missing many Pi-Hole features
  • Documentation is not yet available
  • Not recommended for production use

We are moving fast to implement core blocking functionality.

PRIVACY

PitSinkr keeps all your DNS data local. No telemetry or data sharing.

CONTRIBUTING

We welcome contributions of all kinds. This is a community project.

Ways to help:

  • Report bugs and issues
  • Suggest features
  • Submit code (Go or TypeScript)
  • Improve documentation
  • Test on different hardware

DEVELOPMENT The project is split into:

  • Go core for DNS server and logic
  • TypeScript/React frontend

LICENSE

This project is licensed under the MIT License.

THANK YOU

Thank you for your interest in PitSinkr. Stay tuned as we build a powerful next-generation DNS sinkhole.

Made with Love Sponsor This Project

About

Free and open source DNS sinkhole designed to block ads, trackers, malware domains, and unwanted content at the network level.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages