README.md

Installation on a Raspberry Pi

This document describes how to install the Network Monitor on your Raspberry Pi.

It has been tested with a Raspberry Pi Zero with Wireless network and with an Ethernet adapter.

Netmon on a Raspberry Pi Zero

Installation steps

• Install Ansible on your computer.
• Checkout this repository:

  git clone https://github.com/bkahlert/netmon.git
  cd netmon/ansible

• Install Ansible requirements:

  ansible-galaxy install -r requirements.yml

• Copy the sample inventory to inventory/berries and adapt it to your needs:

  cp -r inventory/sample inventory/berries

Flash Raspberry Pi OS Lite image to your SD card.

• Boot your Raspberry Pi and connect it to your network.
• Start the installation using:

  # Setup only the device foo.local
  ansible-playbook playbook.yml -l foo.local
  
  # Setup only the device foo.local declared in the given inventory, and use the specified IP address to connect
  ansible-playbook playbook.yml -l foo.local \
      -e "ansible_host=10.10.10.99" \
      -i inventory/other/hosts.yml

  or in combination with Pi Hero:

  # Setup only the device foo.local
  ansible-playbook playbook.yml --tags netmon,pihero -l foo.local
  
  # Setup only the device foo.local declared in the given inventory, and use the specified IP address to connect
  ansible-playbook playbook.yml --tags netmon,pihero -l foo.local \
      -e "ansible_host=10.10.10.99" \
      -i inventory/other/hosts.yml

Optional steps

Disable Wi-Fi

If you don't have a Wi-Fi interface, or just don't want to use it, you can disable the appropriate service. This speeds up the boot process and reduces the number of log errors.

sudo systemctl stop hostapd
sudo systemctl disable hostapd