Incorrect documentation

Help Community Help
1

I uninstalled and reinstalled PiHole as a last ditch effort to get it working again.

For the sake of laziness I thought I would keep the existing saved password.

So: How to change the password on PiHole?
How to change password

pihole -h
Usage: pihole [options]
Example: 'pihole allow -h'
Add '-h' after specific commands for more information on usage

Domain Options:
  allow, allowlist    Allow domain(s)
  deny, denylist      Deny domain(s)
  --regex, regex      Regex deny domains(s)
  --allow-regex       Regex allow domains(s)
  --wild, wildcard    Wildcard deny domain(s)
  --allow-wild        Wildcard allow domain(s)
                        Add '-h' for more info on allow/deny usage

Debugging Options:
  -d, debug           Start a debugging session
                        Add '-c' or '--check-database' to include a Pi-hole database integrity check
                        Add '-a' to automatically upload the log to tricorder.pi-hole.net
  -f, flush           Flush the Pi-hole log
  -r, repair          Repair Pi-hole subsystems
  -t, tail [arg]      View the live output of the Pi-hole log.
                      Add an optional argument to filter the log
                      (regular expressions are supported)
  api <endpoint>      Query the Pi-hole API at <endpoint>
                        Precede <endpoint> with 'verbose' option to show authentication and status messages


Options:
  setpassword [pwd]   Set the password for the web interface
                        Without optional argument, password is read interactively.
                        When specifying a password directly, enclose it in single quotes.
  -g, updateGravity   Update the list of ad-serving domains
  -h, --help, help    Show this help dialog
  -l, logging         Specify whether the Pi-hole log should be used
                        Add '-h' for more info on logging usage
  -q, query           Query the adlists for a specified domain
                        Add '-h' for more info on query usage
  -up, updatePihole   Update Pi-hole subsystems
                        Add '--check-only' to exit script before update is performed.
  -v, version         Show installed versions of Pi-hole, Web Interface & FTL
  uninstall           Uninstall Pi-hole from your system
  status              Display the running status of Pi-hole subsystems
  enable              Enable Pi-hole subsystems
                        Add '-h' for more info on enable usage
  disable             Disable Pi-hole subsystems
                        Add '-h' for more info on disable usage
  reloaddns           Update the lists and flush the cache without restarting the DNS server
  reloadlists         Update the lists WITHOUT flushing the cache or restarting the DNS server
  checkout            Switch Pi-hole subsystems to a different GitHub branch
                        Add '-h' for more info on checkout usage
  arpflush            Flush information stored in Pi-hole's network tables

There is no -a option.

2

You found an old thread. In version 6 this was changed to pihole setpassword(may need sudo). This is also present in the help text you provided:

1 Like
3

Thanks.

I've been caught recently looking for answers for.... some program and taking answers from another site.

It is a bit poor that it was from a PiHole site.
Ok, things change.

But if I do a search, you would hope that the latest things are offered too.
Or (better still) not too but before the alternative one, so the latest commands are shown before the older ones.

4

The documentation is actually correct: The  pihole  Command - Pi-hole documentation

Forums tend to contain a lot of obsolete information over the time, it's just how it is everywhere.

5

Well, according to what I am seeing, the command isn't shown.

I tried the command as I thought.

I basically got back unknown command.

I did the pihole -h and got a list of what IS accepted.

I can't see a -a option.

So could you elaborate on that claim?

6

That option no longer exists.
It's just "pihole setpassword" now.

7

Yes, fine in hind sight.

Look at the site where I got the command.

So it is not helpful for people like me who don't know everything and search and are given the wrong command.

Anyway, now I am stuck with the DHCP reservations, and why PiHole isn't blocking URLs in my block list.

8

Where did you search? Google?

1 Like
9

The link I looked at is:

It says to use pihole -a -p which is no longer supported, and you have to use pihole -password

10

You looked at an old post.

It's a post from 2018!
We cannot change what was written in the past.

This is wrong!

You need to use pihole setpassword.

11

No/yes (which ever), and accept that.

But you should maybe make the newer information EASIER to get to.
That way eliminating all these problems.

12

It is already in our documentation page (the correct place to look for Pi-hole command information):
The pihole Command - Pi-hole documentation - Password

1 Like
13

This topic was automatically closed 21 days after the last reply. New replies are no longer allowed.