Giter Club home page Giter Club logo

balena-pihole's Introduction

balena-pihole

If you're looking for a way to quickly and easily get up and running with a Pi-hole device for your home network, this is the project for you.

This project is a balenaCloud stack with the following services:

balenaCloud is a free service to remotely manage and update your Raspberry Pi through an online dashboard interface, as well as providing remote access to the Pi-hole web interface without any additional configuation.

Getting Started

To get started you'll first need to sign up for a free balenaCloud account and flash your device.

https://www.balena.io/docs/learn/getting-started

Deployment

Once your account is set up, deployment is carried out by downloading the project and pushing it to your device either via Git or the balena CLI.

Application Environment Variables

Application envionment variables apply to all services within the application, and can be applied fleet-wide to apply to multiple devices.

Name Example Purpose
TZ America/Toronto To inform services of the timezone in your location, in order to set times and dates within the applications correctly. Find a list of all timezone values here.
DNSMASQ_LISTENING eth0 We set this to eth0 to indicate we want DNSMASQ to listen on the ethernet interface of the Raspberry Pi. If you're connecting to your network with WiFi replace this with wlan0
INTERFACE eth0 As above.
WEBPASSWORD mysecretpassword (optional) password for accessing the web-based interface of Pi-hole - you won’t be able to access the admin panel without defining a password here.
DNS1 127.0.0.1#5300 (optional) Tell Pi-hole where to forward DNS requests that aren’t blocked. We’re using the dnscrypt-proxy project here but you can specify your own.
DNS2 127.0.0.1#5300 (optional) Secondary DNS server - see above.

Usage

Note that you can change the dnscrypt-proxy upstream servers with some minor tweaks in dnscrypt-proxy/Dockerfile.

Help

If you're having trouble getting the project running, submit an issue or post on the forums at https://forums.balena.io.

Author

Kyle Harding [email protected]

Acknowledgments

License

MIT License

balena-pihole's People

Contributors

chrisys avatar klutchell avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.