Docker

TapMap supports running in Docker on Linux hosts.

Docker support is intended for users who want to monitor network activity on a Linux system without installing TapMap directly on the host.

Docker Desktop on Windows and macOS is not supported.

Run from Docker Hub

The published Docker image supports:

Create a local data directory:

mkdir -p ~/tapmap-data

Start TapMap:

docker run --rm \
  --network host \
  --pid host \
  -v ~/tapmap-data:/data \
  -e TAPMAP_IN_DOCKER=1 \
  olalie/tapmap:latest

The mounted host directory is used as the container data directory (/data).

If no supported GeoIP databases are found, GeoIP Database Management opens automatically and guides you through the installation process.

Open:

http://127.0.0.1:8050

By default, TapMap listens on:

0.0.0.0

when running in Docker.

If the host machine has IP address:

192.168.1.50

TapMap can be accessed from another machine using:

http://192.168.1.50:8050

TapMap supports runtime configuration through environment variables.

A common example is changing the default port:

-e TAPMAP_PORT=8060

TapMap always shows network activity.

Process visibility in Docker depends on host security policies.

On Ubuntu with the default Docker AppArmor profile (docker-default), SYS_PTRACE alone was not sufficient.

In this setup, process names became available with:

--cap-add=SYS_PTRACE
--security-opt apparmor=unconfined

Behavior may vary across systems.

Docker does not automatically download newer versions of an existing image.

To update:

docker pull olalie/tapmap:latest

or start the container with:

docker run --pull always ...

For advanced users, a Docker image can be built directly from the repository.

Build the image:

docker build -t tapmap .

Start using the provided Docker Compose configuration:

docker compose -f compose_linux.yaml up

TapMap requires GeoIP databases to display locations on the map.

GeoIP databases are stored in the directory mounted to /data.

For example:

-v ~/tapmap-data:/data

stores the databases in:

~/tapmap-data

on the host system.

For installation, updates, manual installation, and provider selection, see GeoIP Database Management.

Verify that supported GeoIP databases are installed and detected.

Verify: