From 06f5983f53cfa08c477f5ed79a02174ec056b8a9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Christian=20K=C3=B6nig?= Date: Thu, 14 Apr 2022 20:10:43 +0200 Subject: [PATCH] Adjust OS warning to reflect not passing the whole environment MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Christian König --- docs/main/prerequisites.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/main/prerequisites.md b/docs/main/prerequisites.md index c97b208..6907619 100644 --- a/docs/main/prerequisites.md +++ b/docs/main/prerequisites.md @@ -36,7 +36,25 @@ The following operating systems are **officially** supported: It is possible that Pi-hole will install and run on variants of the above, but we cannot test them all. If you are using an operating system not on this list you may see the following message: - ![non-supported OS warning](../images/OSWarning.png) +```bash + [✗] Unsupported OS detected: Debian 16 + If you are seeing this message and you do have a supported OS, please contact support. + + https://docs.pi-hole.net/main/prerequesites/#supported-operating-systems + + If you wish to attempt to continue anyway, you can try one of the following commands to skip this check: + + e.g: If you are seeing this message on a fresh install, you can run: + curl -sSL https://install.pi-hole.net | sudo PIHOLE_SKIP_OS_CHECK=true bash + + If you are seeing this message after having run pihole -up: + sudo PIHOLE_SKIP_OS_CHECK=true pihole -r + (In this case, your previous run of pihole -up will have already updated the local repository) + + It is possible that the installation will still fail at this stage due to an unsupported configuration. + If that is the case, you can feel free to ask the community on Discourse with the Community Help category: + https://discourse.pi-hole.net/c/bugs-problems-issues/community-help/ +``` You can disable this check by setting an environment variable named `PIHOLE_SKIP_OS_CHECK` to `true`, however Pi-hole may have issues installing. If you choose to use this environment variable, please use the [Community Help](https://discourse.pi-hole.net/c/bugs-problems-issues/community-help/36) topic on Discourse to troubleshoot any installation issues you may (or may not!) have.