Skip to content
This repository was archived by the owner on Feb 21, 2025. It is now read-only.

Create a connection

Jump to bottom
Juan Gilsanz Polo edited this page Sep 12, 2022 · 4 revisions

How to create a connection

On this page, there are explained all the instructions about how to create a connection to the server with different circunstances. These are the most common cases. There may be other configurations that aren't covered by this guide.

Basic connection

The simplest case. The Pi-hole server usually is installed on a Raspberry Pi and the web administration panel is on the default port (80).

  • IP address or domain: your Pi-hole server IP
  • Subroute: empty
  • Port: empty
  • HTTP/HTTPS: HTTP

Basic connection with custom port

The Pi-hole server is usually installed on a Docker container or virtual machine.

  • IP address or domain: your Pi-hole server IP
  • Subroute: empty
  • Port: the port you are using for the web administration panel
  • HTTP/HTTPS: HTTP

HTTPS connection

You have enabled HTTPS connections on your Pi-hole server config, but you access it using the default HTTPS port (443).

  • IP address or domain: domain or public IP of the server
  • Subroute: empty
  • Port: empty
  • HTTP/HTTPS: HTTPS

HTTPS connection with custom port (or exposed port)

You have enabled HTTPS connections on your Pi-hole server config and you have an exposed port on your router to access it.

  • IP address or domain: domain or public IP of the server
  • Subroute: empty
  • Port: the port you are exposing for the web administration panel
  • HTTP/HTTPS: HTTPS

HTTPS connection with reverse proxy

You have your Pi-hole server behind a reverse proxy.

  • IP address or domain: your Pi-hole server IP or domain
  • Subroute: the route you are using on your reverse proxy to access Pi-hole web administration panel*
  • Port: empty
  • HTTP/HTTPS: HTTPS

* Example: https://mydomain.com/pihole/admin/index.php

Clone this wiki locally