July 11, 2025

USEFUL-IT

A blog for USEFUL-IT information

Enable SNMP on TurnkeyLinux appliances

Well I had a challenge. I want to monitor the disk usage and the memory usage of my TurnKeyLinux appliances.
So I turn to turnkey to see if an appliance was available for monitoring, and I found it.

 

So I downloaded it and installed it into a virtual machine on my Hyper-V.
As expected, a smooth installation of the appliance.

Next step to configure the appliance, so my other turnkey appliances are monitored, well here came the challenge.
By default the TKL (TurnKeyLinux) appliances do not have SNMP installed, and Observium is a monitoring tool that monitors systems using SNMP.

I finally managed to get SNMP installed and configured. In the next chapter I will explain how I did it…..

 

Installing SNMP on TurnkeyLinux Appliances.

Start an SSH towards the system you want SNMP installed on.

Login as root or as a user with root permissions

Update the packages

apt-get update

Install SNMP

apt-get install snmpd

The installation of SNMP is now completed, Yes it’s that simple, but we are not there yet.
We still need to configure the SNMP agent so that Observium is able to pull the SNMP traps from the system.

Configuring SNMP on TurnKeyLinux Appliances.

First I backed up the current configuration, I would like to create a baseline before I change anything on systems.
If I screw up I can easily restore the original configuration.

To ensure the original configuration is saved type the following commands :

cp /etc/snmp/snmp.conf /etc/snmp/snmp.conf.bak
cp /etc/snmp/snmpd.conf /etc/snmp/snmpd.conf.bak

Now we configure the snmpd.conf, this the only one you need to configure.

Edit the snmpd.conf by typing the following command :

nano /etc/snmp/snmpd.conf

Find the line

    agentAddress udp:127.0.0.1:161

Place a # at the front of the line

Find the line

    #agentAddress udp:161,udp6:[::1]:161

And remove the # at the front of the line

Your configuration should now look like this.

###############################################################################
#
# AGENT BEHAVIOUR

#
# Listen for connections from the local system only
#agentAddress udp:127.0.0.1:161
# Listen for connections on all interfaces (both IPv4 *and* IPv6)
agentAddress udp:161,udp6:[::1]:161

Now the SNMP agent listens to other devices, of course you can adjust the line so the agent only listens to your Monitoring system.
Then adjust the line to:

    agentAddress udp:<IP of monitoring system>:161,udp6:[::1]:161

If you are not using IPv6 than you also can remove the udp6:[::1]:161 from the line.

If this good for you turn to saving and enabling the new SNMP config, to finalize. Otherwise follow the next to configure SNMPv3.

Configuring SNMPv3 on TurnKeyLinux Appliances.

In the same file find the following line :

# createUser authOnlyUser MD5 “remember to change this password”

Remove the # at the front of the line

Think of a password you want to use for the connection from observium using SNMPv3, because SNMPv3 required a username and password.

Place the password behind the MD5 end removing the text “Remember to change this password”

You configuration should now look like :

###############################################################################
#
# SNMPv3 AUTHENTICATION
#
# Note that these particular settings don’t actually belong here.
# They should be copied to the file /var/lib/snmp/snmpd.conf
# and the passwords changed, before being uncommented in that file *only*.
# Then restart the agent

createUser authOnlyUser MD5 <Password>
# createUser authPrivUser SHA “remember to change this one too” DES <password>
# createUser internalUser MD5 “this is only ever used internally, but still change the password”

# If you also change the usernames (which might be sensible),
# then remember to update the other occurances in this example config file to match.

Let me explain the createUser..

Username Authentication Type Privilege Extra Authentication
authOnlyUser MD5 Full READONLY n/a
authPrivUser SHA Full READWRITE DES
internalUser MD5 Full READWRITE n/a

 

The authOnlyUser is fine for now.

Saving and enabling the new SNMP config

In the editor press and type

CTRL – X
Y
<enter>

To save the SNMPD.conf file

Enabling the SNMPD settings.

At the root command prompt type the following command :

/etc/init.d/snmpd restart

SNMP will now be restarted and the new config is applied.

This finalizes the configuration

Now turn to you Observium appliance and add the device to the monitoring system

Remember to use the SNMP v3 username and password you previously configured to connect to the system.

Username : authOnlyUser

Password : <password>

 

Here the screenshot from Observium on how to add the device.

 

About The Author