28d5334767
## [0.62.25](https://github.com/pommee/goaway/compare/v0.62.24...v0.62.25) (2025-12-20) ### Bug Fixes * use net package instead of parsing raw strings for ip ([fb0b3bb](fb0b3bb9a8)) ### Documentation * add 'api.jwtSecret' to documentation ([b8eb1af](b8eb1af46c)) ### UI/UX * remove 'lucide-react' related and confetti library to minimize build. Also updated the rest of client dependencies ([918d4ba](918d4ba8f0))
A lightweight DNS sinkhole for blocking unwanted domains at the network level. Block ads, trackers, and malicious domains before they reach your devices.
Getting started
Instructions for installation, configuration and more can be found on the homepage: https://pommee.github.io/goaway
Features
- 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.