container: portracker

[mostafa-wahied]

Prerequisites

• I have searched the issues and confirmed this container has not been suggested before
• I have verified the container image is actively maintained
• I have tested this container configuration

Container ID

portracker

Display Name

portracker

Description

Portracker is an open-source, self-hosted dashboard designed for homelabs and Docker environments that automatically discovers and displays services and their associated ports, providing a real-time map of your network and preventing deployment failures due to port conflicts.

Category

Networking

Tags

Monitoring, Network, Dashboard

GitHub URL

https://github.com/mostafa-wahied/portracker

Icon URL

https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/portracker.svg

Docker Compose Service Definition

services:
  portracker:
    image: mostafawahied/portracker:latest
    container_name: portracker
    restart: unless-stopped
    pid: "host"  # Required for port detection
    # Required permissions for system ports service namespace access
    cap_add:
      - SYS_PTRACE     # Linux hosts: read other PIDs' /proc entries
      - SYS_ADMIN      # Docker Desktop: allow namespace access for host ports (required for MacOS)
    security_opt:
      - apparmor:unconfined # Required for system ports
    volumes:
      # Required for data persistence
      - ./portracker-data:/data
      # Required for discovering services running in Docker
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - "4999:4999"
    # environment:
      # Optional: For enhanced TrueNAS features
      # - TRUENAS_API_KEY=your-api-key-here

Additional Information

No response