Update

Checking if an update is available

To check if there is an update available for munin-pihole-plugins, use the -v, version, --version command.

Example: munin-pihole-plugins --version

Sample output:

saint@sainternet:~$ munin-pihole-plugins --version
  [ℹ] munin-pihole-plugins version is v01.23.45 (Latest: v67.89.10)

The -v, version, --version command will report the current and latest versions of munin-pihole-plugins, using a DNS query for a TXT record at one of two specially crafted domains (munin-pihole-plugins.sainternet.xyz and munin-pihole-plugins-dev.sainternet.xyz for master and development branches respectively) to ascertain the latest version.

^{_{Note: sample version numbers used}}

Checking the version manually using dig

This can be tested manually using dig.

Example: dig txt munin-pihole-plugins.sainternet.xyz

or,

dig txt +short munin-pihole-plugins-dev.sainternet.xyz

Sample output:

saint@sainternet:~$ dig txt munin-pihole-plugins.sainternet.xyz
...
;; QUESTION SECTION:
;munin-pihole-plugins.sainternet.xyz. IN	TXT

;; ANSWER SECTION:
munin-pihole-plugins.sainternet.xyz. 60	IN TXT	"version: 45.67.89"

;; AUTHORITY SECTION:
sainternet.xyz.		1800	IN	NS	dns1.registrar-servers.com.
sainternet.xyz.		1800	IN	NS	dns2.registrar-servers.com.
...

The version is contained in the ;; ANSWER_SECTION: of the response.

^{_{Note: sample version number used}}

Updating munin-pihole-plugins

To update munin-pihole-plugins, simply run the -i, install, --install command again. Any or all of the configuration parameters may be reconfigured at this time.

The munin-pihole-plugins script will update itself automatically before installation if a newer version is available, this behaviour can be disabled by setting UPDATE_SELF to any value other than true.

Example: munin-pihole-plugins --configure UPDATE_SELF false