{"id":30598638,"url":"https://github.com/tsaouste/pihole-vpn-setup","last_synced_at":"2026-04-07T08:32:27.988Z","repository":{"id":311802680,"uuid":"1045118626","full_name":"tsaouste/pihole-vpn-setup","owner":"tsaouste","description":"This project installs and configures Pi-hole and PiVPN (WireGuard/OpenVPN) on a Raspberry Pi, with UFW firewall, security hardening, and optional automation features.","archived":false,"fork":false,"pushed_at":"2025-09-21T05:22:45.000Z","size":48,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-21T07:16:27.692Z","etag":null,"topics":["ad-block","ad-blocker","ad-blocking","ad-free","openvpn","openvpn-server","pihole","pivpn","raspberry","raspberry-pi","raspberry-pi-zero-w","raspberrypi","raspbian","ufw","ufw-firewall","vpn","vpn-server","wireguard","wireguard-vpn"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tsaouste.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-26T17:21:06.000Z","updated_at":"2025-09-21T05:22:48.000Z","dependencies_parsed_at":"2025-08-27T00:15:15.347Z","dependency_job_id":"70f04f89-4dda-45d0-b9db-75c46a0c0a65","html_url":"https://github.com/tsaouste/pihole-vpn-setup","commit_stats":null,"previous_names":["tsaouste/pihole-vpn-setup"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tsaouste/pihole-vpn-setup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsaouste%2Fpihole-vpn-setup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsaouste%2Fpihole-vpn-setup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsaouste%2Fpihole-vpn-setup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsaouste%2Fpihole-vpn-setup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tsaouste","download_url":"https://codeload.github.com/tsaouste/pihole-vpn-setup/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tsaouste%2Fpihole-vpn-setup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31506562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ad-block","ad-blocker","ad-blocking","ad-free","openvpn","openvpn-server","pihole","pivpn","raspberry","raspberry-pi","raspberry-pi-zero-w","raspberrypi","raspbian","ufw","ufw-firewall","vpn","vpn-server","wireguard","wireguard-vpn"],"created_at":"2025-08-29T23:01:00.896Z","updated_at":"2026-04-07T08:32:27.967Z","avatar_url":"https://github.com/tsaouste.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pi-hole VPN Setup (`pihole-vpn-setup`)\n\n🚀 **Ad-free browsing, everywhere you go**  \nThis project installs and configures **Pi-hole** and **PiVPN** (WireGuard/OpenVPN) on a Raspberry Pi, with **UFW firewall**, security hardening, and optional automation features.  \n\nThe script is fully interactive — guiding you step by step while letting you customize the configuration.  \n\n---\n\n## ✨ Features\n- ✅ **Pi-hole installation \u0026 management**  \n- ✅ **PiVPN setup** (WireGuard or OpenVPN)  \n- ✅ **UFW firewall rules** with interactive prompts  \n- ✅ **Security hardening** (ICMP, IPv6, `/tmp`, `/dev/shm`)  \n- ✅ **Automatic updates \u0026 scheduled reboots**  \n- ✅ **Friendly interactive prompts** for every choice  \n- ✅ Can be safely **re-run anytime** to adjust settings  \n\n---\n\n## 📦 Installation\nDownload and install the latest release with just two commands:\n\n```bash\nwget https://raw.githubusercontent.com/tsaouste/pihole-vpn-setup/refs/heads/main/pihole-vpn-setup.sh\n```\n```bash\nchmod +x pihole-vpn-setup.sh\n```\n---\n\n## ▶️ Usage\nAfter installation, simply run:\n\n```bash\nsudo ./pihole-vpn-setup.sh\n```\n\nThe script will check what’s already installed and skip unnecessary steps.\nYou can re-run it anytime to adjust firewall rules, or reconfigure services.\n\n---\n\n## 🛠 Requirements\n- Raspberry Pi (Zero 2 W or newer recommended)\n- Raspberry Pi OS Lite (64-bit)\n- Ethernet connection (preferred for stability)\n- Sudo privileges\n\n---\n\n## 📚 Project Details\n- 🔒 Security-first: designed to expose only VPN ports. Pi-hole services are available only via VPN or LAN.\n- ⚡ Lightweight: unnecessary services (Bluetooth, Avahi, WPA, etc.) can be disabled interactively.\n- 🌍 Mobile friendly: connect your phone via VPN → enjoy ad-free internet anywhere.\n\n---\n\n## 👨‍💻 Credits\nThis entire project was written with the help of ChatGPT (OpenAI),\nfine-tuned through many iterations of testing and customization.\n\n---\n\n## 📝 License\nMIT License – feel free to use, share, and modify with attribution.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsaouste%2Fpihole-vpn-setup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftsaouste%2Fpihole-vpn-setup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftsaouste%2Fpihole-vpn-setup/lists"}