1e0a567c6a
## [0.62.14](https://github.com/pommee/goaway/compare/v0.62.13...v0.62.14) (2025-11-08) ### Bug Fixes * **deps:** bump golang version and client dependencies ([a966031](a966031119)) * restructure codebase, make setup and flow easier ([75fb86c](75fb86cc00)) ### Documentation * add webpage for installation, configuration, setup and more ([00d0d21](00d0d2115c))
A lightweight DNS sinkhole for blocking unwanted domains at the network level. Block ads, trackers, and malicious domains before they reach your devices.
<<<<<<< HEAD <<<<<<< Updated upstream
Instructions on installation, configuration and more can be found on the homepage.
4619f8f (docs: add webpage for installation, configuration, setup and more)
🌟 Features
=======
Getting started
Instructions for installation, configuration and more can be found on the homepage: https://pommee.github.io/goaway
Features
Stashed changes
- DNS-level domain blocking
- Web-based admin dashboard
- Cross-platform support
- Docker support
- Customizable blocking rules
- Real-time statistics
- Low resource footprint
- And much more...
Contributing
Contributions are welcomed! Here's how you can help:
- Report Issues: Found a bug? Create an issue
- Request Features: Have an idea? Start a discussion or create a feature request
- Submit PRs: Before any work is started, create a new issue explaining what is wanted, why it would fit, how it can be done, so on and so forth...
Once the topic has been discussed with a maintainer then either you or a maintainer starts with the implementation. This is done to prevent any collisions, save time and confusion. Read more here
Platform Support
| Platform | Architecture | Support Level |
|---|---|---|
| Linux | amd64 | Full |
| Linux | arm64 | Full |
| Linux | 386 | Full |
| macOS | amd64 | Beta |
| macOS | arm64 | Beta |
| Windows | amd64 | Beta |
| Windows | 386 | Beta |
Note
: Primary testing is conducted on Linux (amd64). While the aim is to support all listed platforms, functionality on macOS and Windows may vary.
Troubleshooting
Common Issues
Permission Denied (Port 53)
- DNS servers typically require elevated privileges to bind to port 53
Can't Access Dashboard
- Check if port 8080 is available and not blocked by firewall
- Try accessing via
http://localhost:8080on the same machine
DNS Not Working
- Verify GoAway is running and listening on the correct interface
- Check device DNS settings point to GoAway's IP address
- Test with
nslookup google.com <goaway-ip>ordig @<goaway-ip> google.com.
Performance
GoAway is designed to be lightweight and efficient:
- Memory Usage: Typically < 50MB RAM
- CPU Usage: Minimal impact on system performance
- Network: Low latency DNS resolution
- Storage: Logs and statistics use minimal disk space
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
This project is heavily inspired by Pi-hole. Thanks to all people involved for their work.