{"id":8847,"date":"2020-06-17T13:33:32","date_gmt":"2020-06-17T10:33:32","guid":{"rendered":"https:\/\/unihost.com\/help\/?p=8847"},"modified":"2025-05-21T16:45:55","modified_gmt":"2025-05-21T13:45:55","slug":"how-to-install-pi-hole","status":"publish","type":"post","link":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/","title":{"rendered":"How to install Pi-Hole"},"content":{"rendered":"

\"How<\/p>\n

Pi-hole is a caching DNS server with the ability to block ads and other unwanted resources.<\/span><\/p>\n

Initially, the Pi-hole project was developed for Raspberry Pi single-board computers, but over time it became available for most Linux distributions.<\/span><\/p>\n\n\n\n\n<\/colgroup>\n\n\n\n\n\n\n\n
Distribution <\/strong><\/span><\/td>\nRelease<\/strong><\/span><\/td>\nArchitecture<\/strong><\/span><\/td>\n<\/tr>\n
Raspbian<\/span><\/td>\nStretch \/ Buster<\/span><\/td>\nARM<\/span><\/td>\n<\/tr>\n
Ubuntu<\/span><\/td>\n16.x \/ 18.x<\/span><\/td>\nARM \/ x86_64<\/span><\/td>\n<\/tr>\n
Debian<\/span><\/td>\n9 \/ 10<\/span><\/td>\nARM \/ x86_64 \/ i386<\/span><\/td>\n<\/tr>\n
Fedora<\/span><\/td>\n31 \/ 32<\/span><\/td>\nARM \/ x86_64<\/span><\/td>\n<\/tr>\n
CentOS<\/span><\/td>\n7 \/ 8<\/span><\/td>\nx86_64<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

In this guide, we will consider installing on OSs like Centos 7.7, Ubuntu 18.04, and installing on VPS + OpenVPN.<\/span><\/p>\n

Install Pi-hole on Centos 7.7<\/span><\/h2>\n

First, you need to check the status of SELinux and disable it if necessary:<\/span><\/p>\n

sestatus<\/span><\/pre>\n
\"How<\/span><\/p>\n
open SELinux configuration file with any editor<\/span><\/p>\n
mcedit \/etc\/selinux\/config<\/span><\/pre>\n
and change the SELINUX value to disabled<\/span><\/p>\n
\"How<\/span><\/p>\n
then reboot the server. Further, the entire installation is reduced to one command:<\/span><\/p>\n
curl -sSL https:\/\/install.pi-hole.net | bash<\/span><\/pre>\n
Then the installation script will be launched and following the prompts complete the installation.<\/span><\/p>\n
\"How<\/span><\/p>\n
Now we are ready to move on to our newly installed Pi-Hole control panel. You can access it in your browser by typing \u201chttp:\/\/xxx.xxx.xxx.xxx\/admin\u201d or \u201chttp:\/\/pi.hole\/admin\u201d. Change the IP address (xxx.xxx.xxx.xxx) according to your settings.<\/span><\/p>\n
\"How<\/span><\/p>\n
\"How<\/span><\/p>\n
Install Pi-hole on Ubuntu 18.04<\/span><\/h2>\n
Installation on Ubuntu 18.04 comes down to one command:<\/span><\/p>\n
curl -sSL https:\/\/install.pi-hole.net | bash<\/span><\/pre>\n
\"How<\/p>\n
After the installation is complete, you will receive a message with a password to access the web interface and a hint with the necessary command to change it.<\/span><\/p>\n
\"How<\/p>\n
Install Pi-hole on VPS + OpenVPN<\/span><\/h2>\n
This guide is intended to configure OpenVPN on a virtual server hosted in the cloud (for example, Cloudvps<\/a><\/em>). This installation and configuration provide maximum protection for your traffic and filtering DNS queries when using public networks.<\/span><\/p>\n
First, download the OpenVPN installer and make it executable, and then run it:<\/span><\/p>\n
wget https:\/\/git.io\/vpn -O openvpn-install.sh\nchmod 755 openvpn-install.sh\n.\/openvpn-install.sh\n<\/span><\/span><\/span><\/pre>\n
\"How<\/p>\n
\"How<\/p>\n
\"How<\/p>\n
Then install Pi-Hole and select tun0 as the interface and 10.8.0.1\/24 as the IP address. You can accept the rest of the default values \u200b\u200bor customize the Pi-hole to your liking. Choosing an interface is the most important step. If you do not select tun0 (at least to begin with), it will not work properly.<\/span><\/p>\n
\"How<\/p>\n
\"How<\/p>\n
\"How<\/p>\n
\"How<\/p>\n
Edit the OpenVPN configuration file using your favorite editor:<\/span><\/p>\n
mcedit \/etc\/openvpn\/server\/server.conf<\/span><\/pre>\n
Change this push “dhcp-option DNS”<\/strong> line to use the IP address of your Pi-hole<\/span><\/p>\n
push \"dhcp-option DNS 10.8.0.1\" \n<\/span><\/span><\/span><\/pre>\n
\"How<\/p>\n
Create a client configuration file (.ovpn).<\/span>
\nNow that the server is configured, you need to create a settings file so that you can use Pi-Hole. You generate the .ovpn settings file by running the installer and selecting 1) Add a new client<\/strong> for each client that will connect to the VPN. You can repeat this process for any number of customers. In this example, we \u201cadd a new user\u201d by giving the .ovpn file the name test<\/strong>, but you can use your own naming strategy.<\/span><\/p>\n
.\/openvpn-install.sh<\/span><\/pre>\n
\"How<\/p>\n
Then export the finished settings file and use it to connect.<\/span><\/p>\n
\"How<\/p>\n","protected":false},"excerpt":{"rendered":"
Pi-hole is a caching DNS server with the ability to block ads and other unwanted resources.<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[158],"tags":[616],"class_list":["post-8847","post","type-post","status-publish","format-standard","hentry","category-dedicated-servers","tag-pi-hole"],"yoast_head":"\nHow to install Pi-Hole - Unihost.FAQ<\/title>\n<meta name=\"description\" content=\"Pi-hole is a caching DNS server with the ability to block ads and other unwanted resources. How to install Pi-Hole\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to install Pi-Hole - Unihost.FAQ\" \/>\n<meta property=\"og:description\" content=\"Pi-hole is a caching DNS server with the ability to block ads and other unwanted resources. How to install Pi-Hole\" \/>\n<meta property=\"og:url\" content=\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/\" \/>\n<meta property=\"og:site_name\" content=\"Unihost.FAQ\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/unihost\/\" \/>\n<meta property=\"article:published_time\" content=\"2020-06-17T10:33:32+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-05-21T13:45:55+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/unihost.com\/help\/wp-content\/uploads\/pi-hole_no_bg-300x300.png\" \/>\n<meta name=\"author\" content=\"Unihost Support\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@unihost\" \/>\n<meta name=\"twitter:site\" content=\"@unihost\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Unihost Support\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"6 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/\"},\"author\":{\"name\":\"Unihost Support\",\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/person\/bb5ae95f38577c920e6a7507888b715a\"},\"headline\":\"How to install Pi-Hole\",\"datePublished\":\"2020-06-17T10:33:32+00:00\",\"dateModified\":\"2025-05-21T13:45:55+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/\"},\"wordCount\":450,\"publisher\":{\"@id\":\"https:\/\/unihost.com\/help\/#organization\"},\"image\":{\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/unihost.com\/help\/wp-content\/uploads\/pi-hole_no_bg-300x300.png\",\"keywords\":[\"pi-hole\"],\"articleSection\":[\"02. Dedicated servers\"],\"inLanguage\":\"en\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/\",\"url\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/\",\"name\":\"How to install Pi-Hole - Unihost.FAQ\",\"isPartOf\":{\"@id\":\"https:\/\/unihost.com\/help\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/unihost.com\/help\/wp-content\/uploads\/pi-hole_no_bg-300x300.png\",\"datePublished\":\"2020-06-17T10:33:32+00:00\",\"dateModified\":\"2025-05-21T13:45:55+00:00\",\"description\":\"Pi-hole is a caching DNS server with the ability to block ads and other unwanted resources. How to install Pi-Hole\",\"breadcrumb\":{\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#breadcrumb\"},\"inLanguage\":\"en\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en\",\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#primaryimage\",\"url\":\"https:\/\/unihost.com\/help\/minio.php?pi-hole_no_bg.png\",\"contentUrl\":\"https:\/\/unihost.com\/help\/minio.php?pi-hole_no_bg.png\",\"width\":512,\"height\":512},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Unihost\",\"item\":\"https:\/\/unihost.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Help\",\"item\":\"https:\/\/unihost.com\/help\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"How to install Pi-Hole\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/unihost.com\/help\/#website\",\"url\":\"https:\/\/unihost.com\/help\/\",\"name\":\"Unihost.FAQ\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/unihost.com\/help\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/unihost.com\/help\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/unihost.com\/help\/#organization\",\"name\":\"Unihost\",\"alternateName\":\"Unihost\",\"url\":\"https:\/\/unihost.com\/help\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en\",\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/unihost.com\/help\/minio.php?2026\/01\/minio.png\",\"contentUrl\":\"https:\/\/unihost.com\/help\/minio.php?2026\/01\/minio.png\",\"width\":300,\"height\":300,\"caption\":\"Unihost\"},\"image\":{\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/unihost\/\",\"https:\/\/x.com\/unihost\",\"https:\/\/www.instagram.com\/unihost\/?hl=en\",\"https:\/\/www.linkedin.com\/company\/unihost-com\",\"https:\/\/www.youtube.com\/channel\/UCITKsxMDnslQY8brN3advgw\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/person\/bb5ae95f38577c920e6a7507888b715a\",\"name\":\"Unihost Support\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en\",\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/a0c9db17c2a0d93e8a0d5ac123f8c5db750ad4d3d5657369c0c4e480f5af77b8?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/a0c9db17c2a0d93e8a0d5ac123f8c5db750ad4d3d5657369c0c4e480f5af77b8?s=96&d=mm&r=g\",\"caption\":\"Unihost Support\"},\"sameAs\":[\"https:\/\/unihost.com\/\"],\"url\":\"https:\/\/unihost.com\/help\/author\/support\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to install Pi-Hole - Unihost.FAQ","description":"Pi-hole is a caching DNS server with the ability to block ads and other unwanted resources. How to install Pi-Hole","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/","og_locale":"en_US","og_type":"article","og_title":"How to install Pi-Hole - Unihost.FAQ","og_description":"Pi-hole is a caching DNS server with the ability to block ads and other unwanted resources. How to install Pi-Hole","og_url":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/","og_site_name":"Unihost.FAQ","article_publisher":"https:\/\/www.facebook.com\/unihost\/","article_published_time":"2020-06-17T10:33:32+00:00","article_modified_time":"2025-05-21T13:45:55+00:00","og_image":[{"url":"https:\/\/unihost.com\/help\/wp-content\/uploads\/pi-hole_no_bg-300x300.png","type":"","width":"","height":""}],"author":"Unihost Support","twitter_card":"summary_large_image","twitter_creator":"@unihost","twitter_site":"@unihost","twitter_misc":{"Written by":"Unihost Support","Est. reading time":"6 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#article","isPartOf":{"@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/"},"author":{"name":"Unihost Support","@id":"https:\/\/unihost.com\/help\/#\/schema\/person\/bb5ae95f38577c920e6a7507888b715a"},"headline":"How to install Pi-Hole","datePublished":"2020-06-17T10:33:32+00:00","dateModified":"2025-05-21T13:45:55+00:00","mainEntityOfPage":{"@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/"},"wordCount":450,"publisher":{"@id":"https:\/\/unihost.com\/help\/#organization"},"image":{"@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#primaryimage"},"thumbnailUrl":"https:\/\/unihost.com\/help\/wp-content\/uploads\/pi-hole_no_bg-300x300.png","keywords":["pi-hole"],"articleSection":["02. Dedicated servers"],"inLanguage":"en"},{"@type":"WebPage","@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/","url":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/","name":"How to install Pi-Hole - Unihost.FAQ","isPartOf":{"@id":"https:\/\/unihost.com\/help\/#website"},"primaryImageOfPage":{"@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#primaryimage"},"image":{"@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#primaryimage"},"thumbnailUrl":"https:\/\/unihost.com\/help\/wp-content\/uploads\/pi-hole_no_bg-300x300.png","datePublished":"2020-06-17T10:33:32+00:00","dateModified":"2025-05-21T13:45:55+00:00","description":"Pi-hole is a caching DNS server with the ability to block ads and other unwanted resources. How to install Pi-Hole","breadcrumb":{"@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#breadcrumb"},"inLanguage":"en","potentialAction":[{"@type":"ReadAction","target":["https:\/\/unihost.com\/help\/how-to-install-pi-hole\/"]}]},{"@type":"ImageObject","inLanguage":"en","@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#primaryimage","url":"https:\/\/unihost.com\/help\/minio.php?pi-hole_no_bg.png","contentUrl":"https:\/\/unihost.com\/help\/minio.php?pi-hole_no_bg.png","width":512,"height":512},{"@type":"BreadcrumbList","@id":"https:\/\/unihost.com\/help\/how-to-install-pi-hole\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Unihost","item":"https:\/\/unihost.com\/"},{"@type":"ListItem","position":2,"name":"Help","item":"https:\/\/unihost.com\/help\/"},{"@type":"ListItem","position":3,"name":"How to install Pi-Hole"}]},{"@type":"WebSite","@id":"https:\/\/unihost.com\/help\/#website","url":"https:\/\/unihost.com\/help\/","name":"Unihost.FAQ","description":"","publisher":{"@id":"https:\/\/unihost.com\/help\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/unihost.com\/help\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en"},{"@type":"Organization","@id":"https:\/\/unihost.com\/help\/#organization","name":"Unihost","alternateName":"Unihost","url":"https:\/\/unihost.com\/help\/","logo":{"@type":"ImageObject","inLanguage":"en","@id":"https:\/\/unihost.com\/help\/#\/schema\/logo\/image\/","url":"https:\/\/unihost.com\/help\/minio.php?2026\/01\/minio.png","contentUrl":"https:\/\/unihost.com\/help\/minio.php?2026\/01\/minio.png","width":300,"height":300,"caption":"Unihost"},"image":{"@id":"https:\/\/unihost.com\/help\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/unihost\/","https:\/\/x.com\/unihost","https:\/\/www.instagram.com\/unihost\/?hl=en","https:\/\/www.linkedin.com\/company\/unihost-com","https:\/\/www.youtube.com\/channel\/UCITKsxMDnslQY8brN3advgw"]},{"@type":"Person","@id":"https:\/\/unihost.com\/help\/#\/schema\/person\/bb5ae95f38577c920e6a7507888b715a","name":"Unihost Support","image":{"@type":"ImageObject","inLanguage":"en","@id":"https:\/\/unihost.com\/help\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/a0c9db17c2a0d93e8a0d5ac123f8c5db750ad4d3d5657369c0c4e480f5af77b8?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/a0c9db17c2a0d93e8a0d5ac123f8c5db750ad4d3d5657369c0c4e480f5af77b8?s=96&d=mm&r=g","caption":"Unihost Support"},"sameAs":["https:\/\/unihost.com\/"],"url":"https:\/\/unihost.com\/help\/author\/support\/"}]}},"_links":{"self":[{"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/posts\/8847","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/comments?post=8847"}],"version-history":[{"count":32,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/posts\/8847\/revisions"}],"predecessor-version":[{"id":17048,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/posts\/8847\/revisions\/17048"}],"wp:attachment":[{"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/media?parent=8847"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/categories?post=8847"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/tags?post=8847"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}