{"id":27100581,"url":"https://github.com/djuuu/ansible-role-netdata-docker","last_synced_at":"2026-04-28T16:05:06.634Z","repository":{"id":286425435,"uuid":"960932760","full_name":"Djuuu/ansible-role-netdata-docker","owner":"Djuuu","description":"Install Netdata Docker Compose project.","archived":false,"fork":false,"pushed_at":"2025-04-07T23:15:40.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T20:57:58.175Z","etag":null,"topics":["ansible","ansible-role","docker","docker-compose","monitoring","netdata"],"latest_commit_sha":null,"homepage":"","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Djuuu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-05T11:39:16.000Z","updated_at":"2025-04-07T23:15:44.000Z","dependencies_parsed_at":"2025-04-06T12:37:13.433Z","dependency_job_id":null,"html_url":"https://github.com/Djuuu/ansible-role-netdata-docker","commit_stats":null,"previous_names":["djuuu/ansible-role-netdata-docker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Djuuu%2Fansible-role-netdata-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Djuuu%2Fansible-role-netdata-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Djuuu%2Fansible-role-netdata-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Djuuu%2Fansible-role-netdata-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Djuuu","download_url":"https://codeload.github.com/Djuuu/ansible-role-netdata-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248111948,"owners_count":21049577,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-role","docker","docker-compose","monitoring","netdata"],"created_at":"2025-04-06T13:20:00.409Z","updated_at":"2026-04-28T16:05:06.629Z","avatar_url":"https://github.com/Djuuu.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"Ansible Role: Netdata-docker\n============================\n\nInstall Netdata Docker Compose project.\n\nNetdata is a distributed real-time, health monitoring platform for systems, hardware, containers \u0026 applications, collecting metrics.\n\n- https://www.netdata.cloud/\n- https://learn.netdata.cloud/docs/netdata-agent/installation/docker\n\nRequirements\n------------\n\nRequires the following to be installed:\n- docker\n- docker compose\n\nRole Variables\n--------------\n\nCommon Docker projects variables:\n\n```yaml\n# Base directory for Docker projects\ndocker_projects_path: # /var/apps\n```\n\nAvailable role variables are listed below, along with default values (see `defaults/main.yml`):\n\n```yaml\n# Docker project variables\n\nnetdata_project_name: netdata\n\n# Docker project dynamic vars (uses `docker_project_name` prefix, adapt if overridden)\n\n# Port targeted by Traefik router\nnetdata_traefik_loadbalancer_server_port: \"{{ netdata_port }}\"\n\n# Scheme targeted by Traefik router\nnetdata_traefik_loadbalancer_server_scheme: \"{{ netdata_api_use_ssl | ternary('https', 'http') }}\"\n\n# Traefik router middlewares\nnetdata_traefik_middlewares: []\n#  - \"internal-access@file\" # see djuuu.traefik_docker templates/dynamic-conf/middlewares/internal-access.yml.j2\n#  - \"basic-auth@file\"      # see djuuu.traefik_docker files/dynamic-conf/middlewares/basic-auth.yml\n\n# Main service additional docker-compose options (ex: cpu_shares, deploy, ...)\nnetdata_service_additional_options: \"\" # |\n#  cpu_shares: 20\n#  deploy:\n#    resources:\n#      limits:\n#        memory: 1024M\n```\n\n```yaml\n# Netdata project variables\n\n# netdata/netdata container version\nnetdata_version: stable\n\nnetdata_extra_deb_packages: []\n#  - fail2ban\n\nnetdata_default_docker_volumes:\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\nnetdata_extra_docker_volumes: []\n#  - comment: https://learn.netdata.cloud/docs/collecting-metrics/authentication-and-authorization/fail2ban\n#    volume: /var/run:/host/var/run:ro\n#  - comment: systemd units monitoring\n#    volume: /run/dbus:/run/dbus:ro\n#  - /other/example:/host/other/example:ro\n\n# https://learn.netdata.cloud/docs/netdata-agent/configuration/securing-agents/web-server-reference#enable-httpstls-support\nnetdata_api_use_ssl: false\n\n# Only useful when netdata_api_use_ssl is true\n# Note: traefik_domains is generated by djuuu.docker_project role, for djuuu.traefik_docker integration\n# See:\n#   - https://github.com/Djuuu/ansible-role-docker-project?tab=readme-ov-file#generated-variables\n#   - https://github.com/Djuuu/ansible-role-docker-project?tab=readme-ov-file#dynamic-variables\n#   - https://github.com/Djuuu/ansible-role-traefik-docker\nnetdata_api_healthcheck_domain: \"{{ traefik_domains[0] | default(none) }}\"\n\n# Connect Agent to Cloud (optional)\nnetdata_claim_token:\nnetdata_claim_rooms: []\n#  - 12345678-9abc-def0-1234-456789abcdef # All nodes\n#  - 23456789-abcd-ef01-2344-56789abcdef0 # Servers\n#  - ...\n\n# Is node ephemeral?\nnetdata_is_ephemeral_node: false\n\n# Local directory for Netdata configuration backup \nnetdata_config_local_path: \"{{ playbook_dir }}/config/netdata/{{ inventory_hostname }}\"\n```\n\n```yaml\n## Streaming\n# https://learn.netdata.cloud/docs/observability-centralization-points/metrics-centralization-points/configuring-metrics-centralization-points\n\n# Streaming API key (parent) (generate with uuidgen)\nnetdata_stream_api_key:\n# Allowed ips (set to false or empty to disable streaming to host)\nnetdata_stream_allow_from: \"*\"\n\n# Streaming target\nnetdata_stream_to_destination:\nnetdata_stream_to_api_key:\n```\n\nConfig files\n------------\n\nFiles in the following locations will be copied in the project's config directory:\n\n- Netdata config:  \n  `config/netdata/{{ inventory_hostname }}/config/netdata.conf`\n- Plugins config:  \n  `config/netdata/{{ inventory_hostname }}/config/go.d/*.conf`  \n  (and other plugin types: `charts.d`, `custom-plugins.d`, `health.d`, `python.d`, `statsd.d`)\n\nDependencies\n------------\n\nThis role depends on :\n- [djuuu.docker_project](https://github.com/Djuuu/ansible-role-docker-project)\n\nSome variables allow integration with:\n- [djuuu.traefik_docker](https://github.com/Djuuu/ansible-role-traefik-docker)\n\nExample Playbooks\n-----------------\n\n```yaml\n- hosts: all\n  gather_facts: false\n\n  roles:\n    - djuuu.netdata_docker\n```\n\n```yaml\n- hosts: all\n  gather_facts: false\n\n  tasks:\n    - name: Backup Netdata config\n      ansible.builtin.include_role:\n        name: djuuu.netdata_docker\n        tasks_from: get-config\n```\n\n```yaml\n- hosts: all\n  gather_facts: false\n\n  tasks:\n    - name: Get Netdata info\n      ansible.builtin.include_role:\n        name: djuuu.netdata_docker\n        tasks_from: get-info\n      tags: [always]\n```\n\nLicense\n-------\n\nBeerware License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjuuu%2Fansible-role-netdata-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjuuu%2Fansible-role-netdata-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjuuu%2Fansible-role-netdata-docker/lists"}