From 058eed5951544506627725d8af5c9350de277121 Mon Sep 17 00:00:00 2001 From: yubiuser Date: Wed, 14 May 2025 10:01:27 +0200 Subject: [PATCH 1/2] Add info how to add local user to pihole group Signed-off-by: yubiuser --- docs/main/post-install.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/main/post-install.md b/docs/main/post-install.md index 1f29d85..d86b5a6 100644 --- a/docs/main/post-install.md +++ b/docs/main/post-install.md @@ -18,3 +18,20 @@ Pi-hole will not be used by the host automatically after installation. To have t ```code static domain_name_servers=127.0.0.1 ``` + +## Adding your local user to the 'pihole' group + +Since version 6 Pi-hole uses a new API for authentication. All CLI commands use this API instead of e.g. direct database manipulation. If a password is set for API access, the CLI commands also need to authenticate. To avoid entering the password everytime on CLI, Pi-hole allows users which are members of the 'pihole' group to authenicate without manually entering the password (this can be disabled with setting `webserver.api.cli_pw` to `false`.) +To add your local user to the 'pihole' group use the following command + +For Debian/Ubuntu/Raspberry Pi OS/Armbian/Fedora/CentOS + +```code +sudo usermod -aG pihole $USER +``` + +For Alpine + +```code +sudo addgroup pihole $USER +``` From a05ae887620ddffd1a0e47bba3bd7fb390d7c264 Mon Sep 17 00:00:00 2001 From: yubiuser Date: Thu, 15 May 2025 21:05:13 +0200 Subject: [PATCH 2/2] Improve wording Co-authored-by: Adam Warner Signed-off-by: yubiuser --- docs/main/post-install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/main/post-install.md b/docs/main/post-install.md index d86b5a6..d45b556 100644 --- a/docs/main/post-install.md +++ b/docs/main/post-install.md @@ -21,7 +21,7 @@ static domain_name_servers=127.0.0.1 ## Adding your local user to the 'pihole' group -Since version 6 Pi-hole uses a new API for authentication. All CLI commands use this API instead of e.g. direct database manipulation. If a password is set for API access, the CLI commands also need to authenticate. To avoid entering the password everytime on CLI, Pi-hole allows users which are members of the 'pihole' group to authenicate without manually entering the password (this can be disabled with setting `webserver.api.cli_pw` to `false`.) +Pi-hole v6 uses a new API for authentication. All CLI commands use this API instead of e.g. direct database manipulation. If a password is set for API access, the CLI commands also need to authenticate. To avoid entering the password everytime on CLI, Pi-hole allows users which are members of the 'pihole' group to authenicate without manually entering the password (this can be disabled by setting `webserver.api.cli_pw` to `false`.) To add your local user to the 'pihole' group use the following command For Debian/Ubuntu/Raspberry Pi OS/Armbian/Fedora/CentOS