diff --git a/docs/main/faq.md b/docs/main/faq.md index a352c4b..2f503ed 100644 --- a/docs/main/faq.md +++ b/docs/main/faq.md @@ -54,58 +54,6 @@ Ask the list maintainer to convert the IDNs to their punycode representation. Internationalizing Domain Names in Applications (IDNA) was conceived to allow client-side use of language-specific characters in domain names without requiring any existing infrastructure (DNS servers, mall servers, etc., including associated protocols) to change. Accordingly, the corresponding original [RFC 3490](https://tools.ietf.org/html/rfc3490) clearly states that IDNA is employed at application level, not on the server side. Hence, DNS servers never see any IDN domain name, which means DNS records do not store IDN domain names at all, only their [Punycode](https://en.wikipedia.org/wiki/Punycode) representations. -### Error while loading data from the long-term database - -If requesting a lot of data from the long-term database you get this error - -```code -An unknown error occurred while loading the data. - -Check the server's log files (/var/log/lighttpd/error-pihole.log) for details. - -You may need to increase PHP memory limit. - -You can find more info in pi-hole's FAQ: -https://docs.pi-hole.net/main/faq/#error-while-loading-data-from-the-long-term-database -``` - -**Solution:** - -You need to increase PHP's memory and restart the server. - -The amount of memory needed depends on many factors: - -- available system RAM, -- other processes running on your device, -- the amount of data you want to process. - -One approach would be to increase the limit by 128M and check if it was enough to retrieve the data. -If not, add another 128M, check again. If not, add another 128M, check again, until you find the best value. - -_Note:_ -Do not assign all available memory as this can freeze your system. -Please consider the possibility that your system does not have enough memory at all to load all the needed data. - -_Steps to increase `memory_limit`:_ - -Open or create `.user.ini` file: - -```bash -sudo nano /var/www/html/.user.ini -``` - -Add (or change) the memory limit (common abbreviation M=megabyte, G=gigabyte): - -```ini -memory_limit = 256M -``` - -Restart the web server: - -```bash -sudo service lighttpd restart -``` - ### In which order are locally defined DNS records used? **Answer:** diff --git a/docs/main/origins.md b/docs/main/origins.md index 08a6128..4db3a56 100644 --- a/docs/main/origins.md +++ b/docs/main/origins.md @@ -8,8 +8,6 @@ Pi-hole being a **advertising-aware DNS/Web server**, makes use of the following - [`dnsmasq`](https://www.thekelleys.org.uk/dnsmasq/doc.html) - a lightweight DNS and DHCP server - [`curl`](https://curl.haxx.se/) - A command-line tool for transferring data with URL syntax -- [`lighttpd`](https://www.lighttpd.net/) - web server designed and optimized for high performance -- [`php`](https://www.php.net/) - a popular general-purpose web scripting language - [AdminLTE Dashboard](https://github.com/ColorlibHQ/AdminLTE) - premium admin control panel based on Bootstrap 3.x - [`sqlite3`](https://www.sqlite.org/index.html) - SQL Database engine diff --git a/docs/main/prerequisites.md b/docs/main/prerequisites.md index 445d54b..287bf77 100644 --- a/docs/main/prerequisites.md +++ b/docs/main/prerequisites.md @@ -73,14 +73,14 @@ Pi-hole needs a static IP address to properly function (a DHCP reservation is ju | Service | Port | Protocol | Notes | | --------------------|:-------------|:---------| --------------------| -| pihole-FTL | 53 (DNS) | TCP/UDP | If you happen to have another DNS server running, such as BIND, you will need to turn it off in order for Pi-hole to respond to DNS queries. | -| pihole-FTL | 67 (DHCP) | IPv4 UDP | The DHCP server is an optional feature that requires additional ports. | -| pihole-FTL | 547 (DHCPv6) | IPv6 UDP | The DHCP server is an optional feature that requires additional ports. | -| lighttpd | 80 (HTTP) | TCP | If you have another Web server already running, such as Apache, Pi-hole's Web server will not work. You can either disable the other Web server or change the port on which `lighttpd` listens, which allows you keep both Web servers running. | +| pihole-FTL | 53 (DNS) | TCP/UDP | If you happen to have another DNS server running, such as BIND, you will need to turn it off in order for Pi-hole to respond to DNS queries. | +| pihole-FTL | 67 (DHCP) | IPv4 UDP | The DHCP server is an optional feature that requires additional ports. | +| pihole-FTL | 547 (DHCPv6) | IPv6 UDP | The DHCP server is an optional feature that requires additional ports. | +| pihole-FTL | 80 (HTTP)
443 (HTTPS) | TCP | If you have another webserver already listening on port `80`/`443`, then `pihole-FTL` will attempt to bind to `8080`/`8443` instead. If neither of these ports are available, `pihole-FTL`'s webserver will be unavailable until such time as ports are configured manually (see configuration option `webserver.port`) | | pihole-FTL | 4711 | TCP | FTL is our API engine and uses port 4711 on the localhost interface. This port should not be accessible from any other interface.| !!! info - The use of lighttpd on port _80_ is optional if you decide not to install the Web dashboard during installation. + The use of pihole-FTL on port _80_ or _443_ is optional if you decide not to install the Web dashboard during installation. The use of pihole-FTL on ports _67_ or _547_ is optional, but required if you use the DHCP functions of Pi-hole. ### Firewalls diff --git a/mkdocs.yml b/mkdocs.yml index da7c2d6..d654a95 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -209,9 +209,9 @@ nav: - 'Using DNSSEC': guides/misc/tor/dnssec.md - 'Allowlist and Denylist editing': guides/misc/allowlist-denylist.md - 'Web server': - - 'NGINX': guides/webserver/nginx.md - - 'Caddy': guides/webserver/caddy.md - - 'Traefik v1 (not in Docker)': guides/webserver/traefik-nodocker.md + #- 'NGINX': guides/webserver/nginx.md + #- 'Caddy': guides/webserver/caddy.md + #- 'Traefik v1 (not in Docker)': guides/webserver/traefik-nodocker.md - 'Traefik v2 (with Docker)': guides/webserver/traefik-v2-docker.md - 'Router setup': - 'ASUS router': routers/asus.md