{
  "schema_version": 1,
  "generated_at": "2026-10-23T00:00:00.000Z",
  "canonical_url": "https://openlogs.fyi/tools/netdata",
  "slug": "netdata",
  "name": "Netdata",
  "tagline": "Monitoring agent that collects metrics from hosts, containers and applications.",
  "replaces": {
    "summary": "Paid infrastructure monitoring services, such as Datadog.",
    "products": [
      {
        "slug": "datadog",
        "name": "Datadog",
        "vendor": "Datadog",
        "url": "https://openlogs.fyi/alternatives/datadog"
      }
    ]
  },
  "stack": [
    {
      "kind": "language",
      "name": "Go"
    }
  ],
  "deployment_methods": [
    "docker_compose"
  ],
  "requirements": {
    "min_ram_mb": null,
    "min_cpu_cores": null,
    "source_url": null
  },
  "license": {
    "spdx": "GPL-3.0",
    "class": "osi",
    "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/LICENSE"
  },
  "business_model": {
    "value": "unknown",
    "notes": "The README at the pinned commit does not state a business model, so it stays unknown.",
    "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/README.md",
    "checked_at": "2026-10-22"
  },
  "difficulty": {
    "value": "medium",
    "reason": "1 service, 13 volume mounts, no env values to set, host access: cap_add, docker_socket, host_network, host_pid. Heuristic score 4 of 11: medium."
  },
  "repository": {
    "owner": "netdata",
    "name": "netdata",
    "url": "https://github.com/netdata/netdata"
  },
  "compose_check": {
    "status": "config_ok",
    "validated_at": "2026-10-22",
    "summary": "config_ok on 2026-10-22"
  },
  "recipe": {
    "version": 1,
    "source_path": "packaging/docker/README.md",
    "source_repo": "netdata/netdata",
    "source_commit_sha": "77a391af6feda65eba3d87136c7ca37dab34872f",
    "source_kind": "app_repo",
    "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md"
  },
  "install_steps": [
    {
      "order": 1,
      "kind": "prerequisite",
      "language": "text",
      "label": "Docker with the Compose plugin",
      "body": "A host with Docker and the Docker Compose plugin. This entry runs from a compose file.",
      "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md#L98-L131",
      "validation_status": "unvalidated"
    },
    {
      "order": 2,
      "kind": "compose",
      "language": "yaml",
      "label": "Save the code block as docker-compose.yml",
      "body": "version: '3'\nservices:\n  netdata:\n    image: netdata/netdata\n    container_name: netdata\n    pid: host\n    network_mode: host\n    restart: unless-stopped\n    cap_add:\n      - SYS_PTRACE\n      - SYS_ADMIN\n    security_opt:\n      - apparmor:unconfined\n    volumes:\n      - netdataconfig:/etc/netdata\n      - netdatalib:/var/lib/netdata\n      - netdatacache:/var/cache/netdata\n      - /:/host/root:ro,rslave\n      - /etc/passwd:/host/etc/passwd:ro\n      - /etc/group:/host/etc/group:ro\n      - /etc/localtime:/etc/localtime:ro\n      - /proc:/host/proc:ro\n      - /sys:/host/sys:ro\n      - /etc/os-release:/host/etc/os-release:ro\n      - /var/log:/host/var/log:ro\n      - /var/run/docker.sock:/var/run/docker.sock:ro\n      - /run/dbus:/run/dbus:ro\n\nvolumes:\n  netdataconfig:\n  netdatalib:\n  netdatacache:\n",
      "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md",
      "validation_status": "config_ok"
    },
    {
      "order": 3,
      "kind": "note",
      "language": "text",
      "label": "What the compose file check ran with",
      "body": "This compose file is copied unchanged from the code block in https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md#L98-L131. The check ran on that block alone. The Docker guide of the project tells the reader to create a docker-compose.yml with this content.",
      "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md#L98-L131",
      "validation_status": "unvalidated"
    },
    {
      "order": 4,
      "kind": "shell",
      "language": "bash",
      "label": "Start it",
      "body": "docker compose up -d",
      "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md",
      "validation_status": "unvalidated"
    },
    {
      "order": 5,
      "kind": "verify",
      "language": "text",
      "label": "Open the app",
      "body": "Open http://localhost:19999. The netdata service uses the host network, so the compose file publishes no port; the docs name port 19999.",
      "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md",
      "validation_status": "unvalidated"
    }
  ],
  "notes": [
    {
      "kind": "gotcha",
      "title": "Some images use the latest tag or no tag",
      "body": "Images without a pinned version: netdata: netdata/netdata (no tag). A later pull can get a different version.",
      "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "The compose file mounts host folders",
      "body": "Host paths mounted into containers: / at /host/root (netdata), /etc/passwd at /host/etc/passwd (netdata), /etc/group at /host/etc/group (netdata), /etc/localtime at /etc/localtime (netdata), /proc at /host/proc (netdata), /sys at /host/sys (netdata), /etc/os-release at /host/etc/os-release (netdata), /var/log at /host/var/log (netdata) and 1 more.",
      "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md",
      "checked_at": "2026-10-22"
    },
    {
      "kind": "gotcha",
      "title": "Some services get elevated host access",
      "body": "netdata uses the host network, netdata shares the host process list, netdata adds Linux capabilities, netdata mounts the Docker socket, which gives it control of Docker on the host.",
      "source_url": "https://github.com/netdata/netdata/blob/77a391af6feda65eba3d87136c7ca37dab34872f/packaging/docker/README.md",
      "checked_at": "2026-10-22"
    }
  ],
  "signals": {
    "captured_at": "2026-10-22",
    "stars": 81088,
    "forks": 6687,
    "open_issues": 459,
    "last_push": "2026-10-22",
    "days_since_push": 0,
    "latest_release": "v2.12.1",
    "latest_release_date": "2026-10-08",
    "days_since_release": 14
  },
  "links": {
    "html": "https://openlogs.fyi/tools/netdata",
    "markdown": "https://openlogs.fyi/tools/netdata.md",
    "json": "https://openlogs.fyi/tools/netdata.json"
  },
  "updated_at": "2026-10-22"
}