Skip to content

Commit e088632

Browse files
authored
Merge pull request #1244 from pi-hole/local_user
Add info how to add local user to pihole group
2 parents 7ca4c0f + a05ae88 commit e088632

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

docs/main/post-install.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,20 @@ Pi-hole will not be used by the host automatically after installation. To have t
1818
```code
1919
static domain_name_servers=127.0.0.1
2020
```
21+
22+
## Adding your local user to the 'pihole' group
23+
24+
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`.)
25+
To add your local user to the 'pihole' group use the following command
26+
27+
For Debian/Ubuntu/Raspberry Pi OS/Armbian/Fedora/CentOS
28+
29+
```code
30+
sudo usermod -aG pihole $USER
31+
```
32+
33+
For Alpine
34+
35+
```code
36+
sudo addgroup pihole $USER
37+
```

0 commit comments

Comments
 (0)