How to install the Fing Agent on Docker

This guide will walk you through the process of installing the Fing-Agent snap package on a Raspberry Pi, QNAP or Synology NAS.  Follow these step-by-step instructions to successfully install the docker image and set up the Fing-Agent container.

Prerequisites

• Ensure that Docker is installed and running.For instructions, refer to the Docker installation guide.
• An active internet connection.

At this time, the Fing Agent image is compatible with ARM-64 and AMD-64 with a single, multi-architecture image. Additional architectures may be added in the future, as the product improves and evolves.

Before you begin

Please note the following restrictions before proceeding with the installation:

• Unsupported Operating Systems: Docker installations of Fing Agent are not supported on Windows or macOS.
• Single Agent per Device: Only one instance of the Fing Agent can run per device. If you already have the Fing Agent installed via Snap on the same device, it must be uninstalled before running the Docker version.
• Snap Migration Limitations: Currently, migration from the Snap version of Fing Agent to Docker is not supported. You must deactivate, uninstall the Snap version, and install the Docker version from scratch.

Installation instructions for Raspberry Pi

• Ensure that Docker is installed and running on your Raspberry Pi. For instructions, refer to the Docker installationguide for Raspberry Pi.

• Open a terminal on your Raspberry Pi and run the following command to install the Fing Agent Docker container:

sudo docker run --network=host --cap-add NET_ADMIN --publish 44444:44444 \
  -d --restart=always --name FingAgent \
  -v fing-data-volume:/app/fingdata fing/fing-agent:beta

This command will:

• • Download the latest beta image: the image from the official Fing account is securely download from DockerHub 
  • Network Mode: Run the container in host network mode for optimal networking capabilities. It will grant access to the underlying networking system, which is required for the agent to work correctly.
  • Capabilities: Add the necessary NET_ADMIN capability for network administration.
  • Port Mapping: Publish port 44444 to publish their status via UPnP.
  • Volume Persistence: Use the fing-data-volume to persist data across container restarts, such as configuration and log files.

After installation, the Fing Agent will automatically start and be available to be activated.

Uninstalling the Snap Version

If you are migrating from a previous Snap installation, follow these steps:

• Deactivate the existing Snap-based Fing Agent on your account. Using the mobile app, open the list of networks and long-tap or swipe to display the actions on that network. Select "Deactivate" to deactivate the snap image.
• Uninstall the Snap version:

sudo snap remove fing-agent

• Proceed with Docker Installation using the instructions provided above.

Running the Fing Agent on NAS (QNAP and Synology)

The Fing Agent can also be run on NAS devices such as QNAP and Synology through Docker. Follow these specific steps to set up the Fing Agent on your NAS.

QNAP NAS

1. Open Container Station: In the QNAP interface, open the Container Station application.
2. Search for Fing Agent: In the Container Station search bar, look for "fing/fing-agent:beta".
3. Configure Network Mode: Before running the container, set the network mode to HOST. This will allow the container to access your network directly.
4. Start Container: After setting up, start the container. The Fing Agent should now be running on your QNAP NAS.

Synology NAS

• Open Docker Application: In the Synology DSM, open the Docker application.
• Search for Fing Agent: In the Docker registry, search for "fing-agent" and download it.

• Configure Network Mode: Under container settings, set the network mode to "Host". Leave the port settings unmodified.

• Start Container: Start the container, and the Fing Agent will be active on your Synology NAS.

How to activate your Fing Agent

You have now successfully started the container running the Fing Agent image on your device. To activate the agent you will need:

• The Fing App running on your mobile
• An active subscription

Open the Fing App on your mobile, select the "Account" tab, tap on "Add monitoring unit" and follow the on-screen instructions to start the activation procedure.