Skip to content

Latest commit

 

History

History
48 lines (39 loc) · 2.24 KB

TROUBLESHOOTING.md

File metadata and controls

48 lines (39 loc) · 2.24 KB

Checking and troubleshooting

The browser shows a pop-up with an error when loading the page

This can have several causes. One is an outdated browser cache. Delete this if necessary.

Furthermore, an invalid character can also lead to an incorrect JSON being generated by the backend. Since JSONs must correspond to a specific schema and many parts in Pi.Alert exchange data in JSON format, this can lead to errors. The "Test Main JSON Calls" function is available for this purpose under Maintenance -> Settings -> Advanced. If you report an issue in this regard, please include the output of this function.

Repairing an installation after a failed update

  1. rename the still existing "pialert" directory e.g. to "pialert-old"
  2. reinstall Pi.Alert
  3. copy the database from "pialert-old/db" to "pialert/db/" and overwrite the existing database there
  4. copy "pialert.conf" from "pialert-old/config" to "pialert/config"
  5. execute the command "./pialert-cli set_permissions" in the "pialert/back" directory
  6. now everything should work again

Broken Scan after Pi-hole update from 5.x to 6.x

Scanning...
    arp-scan Method...
        ...arp-scan: One interface
    Pi-hole 5 Client List Method...
Traceback (most recent call last):
  File "/home/user/pialert/back/pialert.py", line 4195, in <module>
    sys.exit(main())
             ^^^^^^
  File "/home/user/pialert/back/pialert.py", line 102, in main
    res = scan_network()
          ^^^^^^^^^^^^^^
  File "/home/user/pialert/back/pialert.py", line 825, in scan_network
    copy_pihole_network()
  File "/home/user/pialert/back/pialert.py", line 1018, in copy_pihole_network
    copy_pihole_network_five()
  File "/home/user/pialert/back/pialert.py", line 1028, in copy_pihole_network_five
    sql.execute ("ATTACH DATABASE '"+ PIHOLE_DB +"' AS PH")
sqlite3.OperationalError: unable to open database: /etc/pihole/pihole-FTL.db

This is a normal error under these circumstances. This is because Pi.Alert uses different functions for these two different versions. The correct PiHole version must be specified in the Pi.Alert configuration. You can find out how to do this in the documentation of the configuration file pialert.conf.

Back