https://github.com/jacklul/entware-pi-hole
Pi-hole as Entware package
https://github.com/jacklul/entware-pi-hole
ad-blocker dns-server entware opkg pi-hole pihole
Last synced: 11 months ago
JSON representation
Pi-hole as Entware package
- Host: GitHub
- URL: https://github.com/jacklul/entware-pi-hole
- Owner: jacklul
- License: mit
- Created: 2024-04-19T20:22:44.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-24T09:55:44.000Z (over 1 year ago)
- Last Synced: 2024-10-24T19:15:31.450Z (over 1 year ago)
- Topics: ad-blocker, dns-server, entware, opkg, pi-hole, pihole
- Language: Shell
- Homepage: https://jacklul.github.io/entware-pi-hole/
- Size: 78.7 MB
- Stars: 8
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pi-hole for Entware
Run [Pi-hole](https://pi-hole.net) directly on your [Entware](https://github.com/Entware/Entware) supported device.
> [!WARNING]
> **Releases here are unofficial and not supported by the Pi-hole developers.**
Supported Entware architectures: **aarch64-3.10, armv7-3.2, x64-3.2**
## Requirements
You will need around **50 MB** of free memory to run the daemon and **around 100 MB** more to be able to update the gravity database without running out of memory.
Keep in mind that memory requirements increase as you add more blocklists.
Swap file is **recommended**.
## Installation
- Install Entware - check [their wiki](https://github.com/Entware/Entware/wiki) for instructions
- Add this repository to your `opkg.conf` configuration:
```bash
src/gz pi-hole https://jacklul.github.io/entware-pi-hole/[architecture]
# replace [architecture] with one of the supported architectures
```
- Install the package: `opkg update && opkg install pi-hole`
- Start `pihole-FTL` daemon: `/opt/etc/init.d/S65pihole-FTL start`
> [!IMPORTANT]
> The service might initially not start due to ports being in use - make adjustments in `/opt/etc/pihole/pihole.toml` when necessary.
> For device or firmware specific setup instructions check the [wiki](https://github.com/jacklul/entware-pi-hole/wiki).
## Support
Because how different each device can be I won't be able to help with every issue that can be device-specific but feel free to report them anyway.
## License
Contents of this repository are licensed under [MIT](/LICENSE).
Pi-hole® is licensed under [EUPL](https://github.com/pi-hole/pi-hole?tab=License-1-ov-file).