netdata/integrations/deploy.yaml

- &linux
  id: deploy-linux-generic
  meta: &linux_meta
    name: Linux
    link: ""
    categories:
      - deploy.operating-systems
    icon_filename: "linux.svg"
  keywords:
    - linux
  most_popular: true
  install_description: "Run the following command on your node to install and connnect Netdata to your Space:"
  methods:
    - &ks_wget
      method: wget
      commands:
        - channel: nightly
          command: >
            wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh --nightly-channel{% if $showClaimingOptions %} --claim-token {% claim_token %} --claim-rooms {% $claim_rooms %} --claim-url {% claim_url %}{% /if %}
        - channel: stable
          command: >
            wget -O /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh --stable-channel{% if $showClaimingOptions %} --claim-token {% claim_token %} --claim-rooms {% $claim_rooms %} --claim-url {% claim_url %}{% /if %}
    - &ks_curl
      method: curl
      commands:
        - channel: nightly
          command: >
            curl https://get.netdata.cloud/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --nightly-channel{% if $showClaimingOptions %} --claim-token {% claim_token %} --claim-rooms {% $claim_rooms %} --claim-url {% claim_url %}{% /if %}
        - channel: stable
          command: >
            curl https://get.netdata.cloud/kickstart.sh > /tmp/netdata-kickstart.sh && sh /tmp/netdata-kickstart.sh --stable-channel{% if $showClaimingOptions %} --claim-token {% claim_token %} --claim-rooms {% $claim_rooms %} --claim-url {% claim_url %}{% /if %}
  additional_info: &ref_containers >
    Did you know you can also deploy Netdata on your OS using {% goToCategory navigateToSettings=$navigateToSettings categoryId="deploy.docker-kubernetes" %}Kubernetes{% /goToCategory %} or {% goToCategory categoryId="deploy.docker-kubernetes" %}Docker{% /goToCategory %}?
  clean_additional_info: &ref_clean_containers >
    Did you know you can also deploy Netdata on your OS using Kubernetes or Docker?
  related_resources: {}
  platform_info:
    group: ""
    distro: ""
  quick_start: 1
- <<: *linux
  id: deploy-ubuntu
  meta:
    <<: *linux_meta
    name: Ubuntu
    link: https://ubuntu.com/
    icon_filename: "ubuntu.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "ubuntu"
  quick_start: -1
- <<: *linux
  id: deploy-debian
  meta:
    <<: *linux_meta
    name: Debian
    link: https://www.debian.org/
    icon_filename: "debian.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "debian"
  quick_start: -1
- <<: *linux
  id: deploy-fedora
  meta:
    <<: *linux_meta
    name: Fedora
    link: https://www.fedoraproject.org/
    icon_filename: "fedora.png"
  most_popular: false
  platform_info:
    group: "include"
    distro: "fedora"
  quick_start: -1
- <<: *linux
  id: deploy-rhel
  meta:
    <<: *linux_meta
    name: Red Hat Enterprise Linux
    link: https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux
    icon_filename: "rhel.png"
  most_popular: false
  platform_info:
    group: "no_include"
    distro: "rhel"
  quick_start: -1
- <<: *linux
  id: deploy-rockylinux
  meta:
    <<: *linux_meta
    name: Rocky Linux
    link: https://rockylinux.org/
    icon_filename: "rocky.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "rockylinux"
  quick_start: -1
- <<: *linux
  id: deploy-alpinelinux
  meta:
    <<: *linux_meta
    name: Alpine Linux
    link: https://www.alpinelinux.org/
    icon_filename: "alpine.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "alpinelinux"
  quick_start: -1
- <<: *linux
  id: deploy-amazonlinux
  meta:
    <<: *linux_meta
    name: Amazon Linux
    link: https://aws.amazon.com/amazon-linux-2/
    icon_filename: "amazonlinux.png"
  most_popular: false
  platform_info:
    group: "include"
    distro: "amazonlinux"
  quick_start: -1
- <<: *linux
  id: deploy-archlinux
  meta:
    <<: *linux_meta
    name: Arch Linux
    link: https://archlinux.org/
    icon_filename: "archlinux.png"
  most_popular: false
  platform_info:
    group: "include"
    distro: "archlinux"
  quick_start: -1
- <<: *linux
  id: deploy-centos
  meta:
    <<: *linux_meta
    name: CentOS
    link: https://www.centos.org/
    icon_filename: "centos.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "centos"
  quick_start: -1
- <<: *linux
  id: deploy-centos-stream
  meta:
    <<: *linux_meta
    name: CentOS Stream
    link: https://www.centos.org/centos-stream
    icon_filename: "centos.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "centos-stream"
  quick_start: -1
- <<: *linux
  id: deploy-manjarolinux
  meta:
    <<: *linux_meta
    name: Manjaro Linux
    link: https://manjaro.org/
    icon_filename: "manjaro.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "archlinux"
  quick_start: -1
- <<: *linux
  id: deploy-oraclelinux
  meta:
    <<: *linux_meta
    name: Oracle Linux
    link: https://www.oracle.com/linux/
    icon_filename: "oraclelinux.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "oraclelinux"
  quick_start: -1
- <<: *linux
  id: deploy-opensuse
  meta:
    <<: *linux_meta
    name: SUSE Linux
    link: https://www.suse.com/
    icon_filename: "openSUSE.svg"
  most_popular: false
  platform_info:
    group: "include"
    distro: "opensuse"
  quick_start: -1
- id: deploy-macos
  meta:
    name: macOS
    link: ""
    categories:
      - deploy.operating-systems
    icon_filename: "macos.svg"
  most_popular: true
  keywords:
    - macOS
    - mac
    - apple
  install_description: "Run the following command on your Intel based OSX, macOS servers to install and claim Netdata:"
  methods:
    - *ks_curl
  additional_info: *ref_containers
  clean_additional_info: *ref_clean_containers
  related_resources: {}
  platform_info:
    group: "no_include"
    distro: "macos"
  quick_start: 5
- id: deploy-docker
  meta:
    name: Docker
    link: "https://www.docker.com/"
    categories:
      - deploy.docker-kubernetes
    icon_filename: "docker.svg"
  most_popular: true
  keywords:
    - docker
    - container
    - containers
  install_description: |
    Install and connect new Docker containers
    Find the commands for `docker run`, `docker compose` or `Docker Swarm`. On the last two you can copy the configs, then run `docker-compose up -d` in the same directory as the `docker-compose.yml`

    > Netdata container requires different privileges and mounts to provide functionality similar to that provided by Netdata installed on the host. More info [here](https://learn.netdata.cloud/docs/installing/docker?_gl=1*f2xcnf*_ga*MTI1MTUwMzU0OS4xNjg2NjM1MDA1*_ga_J69Z2JCTFB*MTY5MDMxMDIyMS40MS4xLjE2OTAzMTAzNjkuNTguMC4w#create-a-new-netdata-agent-container)
    > Netdata will use the hostname from the container in which it is run instead of that of the host system. To change the default hostname check [here](https://learn.netdata.cloud/docs/agent/packaging/docker?_gl=1*i5weve*_ga*MTI1MTUwMzU0OS4xNjg2NjM1MDA1*_ga_J69Z2JCTFB*MTY5MDMxMjM4Ny40Mi4xLjE2OTAzMTIzOTAuNTcuMC4w#change-the-default-hostname)
  methods:
    - method: Docker CLI
      commands:
        - channel: nightly
          command: |
            docker run -d --name=netdata \
            --pid=host \
            --network=host \
            -v netdataconfig:/etc/netdata \
            -v netdatalib:/var/lib/netdata \
            -v netdatacache:/var/cache/netdata \
            -v /:/host/root:ro,rslave \
            -v /etc/passwd:/host/etc/passwd:ro \
            -v /etc/group:/host/etc/group:ro \
            -v /etc/localtime:/etc/localtime:ro \
            -v /proc:/host/proc:ro \
            -v /sys:/host/sys:ro \
            -v /etc/os-release:/host/etc/os-release:ro \
            -v /var/log:/host/var/log:ro \
            -v /var/run/docker.sock:/var/run/docker.sock:ro \
            -v /run/dbus:/run/dbus:ro \
            --restart unless-stopped \
            --cap-add SYS_PTRACE \
            --cap-add SYS_ADMIN \
            --security-opt apparmor=unconfined \
            {% if $showClaimingOptions %}
            -e NETDATA_CLAIM_TOKEN={% claim_token %} \
            -e NETDATA_CLAIM_URL={% claim_url %} \
            -e NETDATA_CLAIM_ROOMS={% $claim_rooms %} \
            {% /if %}
            netdata/netdata:edge
        - channel: stable
          command: |
            docker run -d --name=netdata \
            --pid=host \
            --network=host \
            -v netdataconfig:/etc/netdata \
            -v netdatalib:/var/lib/netdata \
            -v netdatacache:/var/cache/netdata \
            -v /:/host/root:ro,rslave \
            -v /etc/passwd:/host/etc/passwd:ro \
            -v /etc/group:/host/etc/group:ro \
            -v /etc/localtime:/etc/localtime:ro \
            -v /proc:/host/proc:ro \
            -v /sys:/host/sys:ro \
            -v /etc/os-release:/host/etc/os-release:ro \
            -v /var/log:/host/var/log:ro \
            -v /var/run/docker.sock:/var/run/docker.sock:ro \
            -v /run/dbus:/run/dbus:ro \
            --restart unless-stopped \
            --cap-add SYS_PTRACE \
            --cap-add SYS_ADMIN \
            --security-opt apparmor=unconfined \
            {% if $showClaimingOptions %}
            -e NETDATA_CLAIM_TOKEN={% claim_token %} \
            -e NETDATA_CLAIM_URL={% claim_url %} \
            -e NETDATA_CLAIM_ROOMS={% $claim_rooms %} \
            {% /if %}
            netdata/netdata:stable
    - method: Docker Compose
      commands:
        - channel: nightly
          command: |
            version: '3'
            services:
              netdata:
                image: netdata/netdata:edge
                container_name: netdata
                pid: host
                network_mode: host
                restart: unless-stopped
                cap_add:
                  - SYS_PTRACE
                  - SYS_ADMIN
                security_opt:
                  - apparmor:unconfined
                volumes:
                  - netdataconfig:/etc/netdata
                  - netdatalib:/var/lib/netdata
                  - netdatacache:/var/cache/netdata
                  - /:/host/root:ro,rslave
                  - /etc/passwd:/host/etc/passwd:ro
                  - /etc/group:/host/etc/group:ro
                  - /etc/localtime:/etc/localtime:ro
                  - /proc:/host/proc:ro
                  - /sys:/host/sys:ro
                  - /etc/os-release:/host/etc/os-release:ro
                  - /var/log:/host/var/log:ro
                  - /var/run/docker.sock:/var/run/docker.sock:ro
                  - /run/dbus:/run/dbus:ro
            {% if $showClaimingOptions %}
                environment:
                  - NETDATA_CLAIM_TOKEN={% claim_token %}
                  - NETDATA_CLAIM_URL={% claim_url %}
                  - NETDATA_CLAIM_ROOMS={% $claim_rooms %}
            {% /if %}
            volumes:
              netdataconfig:
              netdatalib:
              netdatacache:
        - channel: stable
          command: |
            version: '3'
            services:
              netdata:
                image: netdata/netdata:stable
                container_name: netdata
                pid: host
                network_mode: host
                restart: unless-stopped
                cap_add:
                  - SYS_PTRACE
                  - SYS_ADMIN
                security_opt:
                  - apparmor:unconfined
                volumes:
                  - netdataconfig:/etc/netdata
                  - netdatalib:/var/lib/netdata
                  - netdatacache:/var/cache/netdata
                  - /:/host/root:ro,rslave
                  - /etc/passwd:/host/etc/passwd:ro
                  - /etc/group:/host/etc/group:ro
                  - /etc/localtime:/etc/localtime:ro
                  - /proc:/host/proc:ro
                  - /sys:/host/sys:ro
                  - /etc/os-release:/host/etc/os-release:ro
                  - /var/log:/host/var/log:ro
                  - /var/run/docker.sock:/var/run/docker.sock:ro
                  - /run/dbus:/run/dbus:ro
            {% if $showClaimingOptions %}
                environment:
                  - NETDATA_CLAIM_TOKEN={% claim_token %}
                  - NETDATA_CLAIM_URL={% claim_url %}
                  - NETDATA_CLAIM_ROOMS={% $claim_rooms %}
            {% /if %}
            volumes:
              netdataconfig:
              netdatalib:
              netdatacache:
    - method: Docker Swarm
      commands:
        - channel: nightly
          command: |
            version: '3'
            services:
              netdata:
                image: netdata/netdata:edge
                pid: host
                network_mode: host
                cap_add:
                  - SYS_PTRACE
                  - SYS_ADMIN
                security_opt:
                  - apparmor:unconfined
                volumes:
                  - netdataconfig:/etc/netdata
                  - netdatalib:/var/lib/netdata
                  - netdatacache:/var/cache/netdata
                  - /:/host/root:ro,rslave
                  - /etc/passwd:/host/etc/passwd:ro
                  - /etc/group:/host/etc/group:ro
                  - /etc/localtime:/etc/localtime:ro
                  - /proc:/host/proc:ro
                  - /sys:/host/sys:ro
                  - /etc/os-release:/host/etc/os-release:ro
                  - /etc/hostname:/etc/hostname:ro
                  - /var/log:/host/var/log:ro
                  - /var/run/docker.sock:/var/run/docker.sock:ro
                  - /run/dbus:/run/dbus:ro
            {% if $showClaimingOptions %}
                environment:
                  - NETDATA_CLAIM_TOKEN={% claim_token %}
                  - NETDATA_CLAIM_URL={% claim_url %}
                  - NETDATA_CLAIM_ROOMS={% $claim_rooms %}
            {% /if %}
                deploy:
                  mode: global
                  restart_policy:
                    condition: on-failure
            volumes:
              netdataconfig:
              netdatalib:
              netdatacache:
        - channel: stable
          command: |
            version: '3'
            services:
              netdata:
                image: netdata/netdata:stable
                pid: host
                network_mode: host
                cap_add:
                  - SYS_PTRACE
                  - SYS_ADMIN
                security_opt:
                  - apparmor:unconfined
                volumes:
                  - netdataconfig:/etc/netdata
                  - netdatalib:/var/lib/netdata
                  - netdatacache:/var/cache/netdata
                  - /:/host/root:ro,rslave
                  - /etc/passwd:/host/etc/passwd:ro
                  - /etc/group:/host/etc/group:ro
                  - /etc/localtime:/etc/localtime:ro
                  - /proc:/host/proc:ro
                  - /sys:/host/sys:ro
                  - /etc/os-release:/host/etc/os-release:ro
                  - /etc/hostname:/etc/hostname:ro
                  - /var/log:/host/var/log:ro
                  - /var/run/docker.sock:/var/run/docker.sock:ro
                  - /run/dbus:/run/dbus:ro
            {% if $showClaimingOptions %}
                environment:
                  - NETDATA_CLAIM_TOKEN={% claim_token %}
                  - NETDATA_CLAIM_URL={% claim_url %}
                  - NETDATA_CLAIM_ROOMS={% $claim_rooms %}
            {% /if %}
                deploy:
                  mode: global
                  restart_policy:
                    condition: on-failure
            volumes:
              netdataconfig:
              netdatalib:
              netdatacache:
  additional_info: ""
  related_resources: {}
  platform_info:
    group: "no_include"
    distro: "docker"
  quick_start: 3
- id: deploy-kubernetes
  meta:
    name: Kubernetes (Helm)
    link: ""
    categories:
      - deploy.docker-kubernetes
    icon_filename: "kubernetes.svg"
  keywords:
    - kubernetes
    - container
    - Orchestrator
  install_description: |
    **Use helm install to install Netdata on your Kubernetes cluster**
    For a new installation use `helm install` or for existing clusters add the content below to your `override.yaml` and then run `helm upgrade -f override.yml netdata netdata/netdata`

  methods:
    - method: Helm
      commands:
        - channel: nightly
          command: |
            helm install netdata netdata/netdata \
            --set image.tag=edge{% if $showClaimingOptions %} \
            --set parent.claiming.enabled="true" \
            --set parent.claiming.token={% claim_token %} \
            --set parent.claiming.rooms={% $claim_rooms %} \
            --set child.claiming.enabled="true" \
            --set child.claiming.token={% claim_token %} \
            --set child.claiming.rooms={% $claim_rooms %}{% /if %}
        - channel: stable
          command: |
            helm install netdata netdata/netdata \
            --set image.tag=stable{% if $showClaimingOptions %} \
            --set parent.claiming.enabled="true" \
            --set parent.claiming.token={% claim_token %} \
            --set parent.claiming.rooms={% $claim_rooms %} \
            --set child.claiming.enabled="true" \
            --set child.claiming.token={% claim_token %} \
            --set child.claiming.rooms={% $claim_rooms %}{% /if %}
    - method: Existing Cluster
      commands:
        - channel: nightly
          command: |
            image:
              tag: edge

            restarter:
              enabled: true
            {% if $showClaimingOptions %}

            parent:
              claiming:
                enabled: true
                token: {% claim_token %}
                rooms: {% $claim_rooms %}

            child:
              claiming:
                enabled: true
                token: {% claim_token %}
                rooms: {% $claim_rooms %}
            {% /if %}
        - channel: stable
          command: |
            image:
              tag: stable

            restarter:
              enabled: true
            {% if $showClaimingOptions %}

            parent:
              claiming:
                enabled: true
                token: {% claim_token %}
                rooms: {% $claim_rooms %}

            child:
              claiming:
                enabled: true
                token: {% claim_token %}
                rooms: {% $claim_rooms %}
            {% /if %}
  additional_info: ""
  related_resources: {}
  most_popular: true
  platform_info:
    group: ""
    distro: ""
  quick_start: 4
- id: deploy-windows
  meta:
    name: Windows
    link: "https://www.microsoft.com/en-us/windows"
    categories:
      - deploy.operating-systems
    icon_filename: "windows.svg"
  keywords:
    - windows
  install_description: |
    Netdata offers a convenient Windows installer for easy setup. This executable provides two distinct installation modes, outlined below.

    ## Graphical User Interface (GUI)

    **Download the MSI Installer**:
      - [Stable version](https://github.com/netdata/netdata/releases/latest/download/netdata-x64.msi)
      - [Nightly version](https://github.com/netdata/netdata-nightlies/releases/latest/download/netdata-x64.msi)

    Double-click the installer to start the installation process. As Netdata adds a service to your system, you'll need to provide administrator privileges.

    Once installed, you can access your Netdata dashboard at `localhost:19999`.

    ## Silent Mode (Command line)

    If you prefer to install Netdata through the command line, you can do so by running the following command on Windows Powershell with administrator rights.
  methods:
    - method: Silent Mode (Command line)
      commands:
        - channel: stable
          command: >
            $ProgressPreference = 'SilentlyContinue';
            Invoke-WebRequest https://github.com/netdata/netdata/releases/latest/download/netdata-x64.msi -OutFile "netdata-x64.msi";
            msiexec /qn /i netdata-x64.msi {% if $showClaimingOptions %}TOKEN={% claim_token %} ROOMS={% $claim_rooms %}{% /if %}
        - channel: nightly
          command: >
            $ProgressPreference = 'SilentlyContinue';
            Invoke-WebRequest https://github.com/netdata/netdata-nightlies/releases/latest/download/netdata-x64.msi -OutFile "netdata-x64.msi";
            msiexec /qn /i netdata-x64.msi {% if $showClaimingOptions %}TOKEN={% claim_token %} ROOMS={% $claim_rooms %}{% /if %}
  additional_info: |
    ### Available CLI Options

    | Option       | Description                                                                                      |
    |--------------|--------------------------------------------------------------------------------------------------|
    | `/qn`        | Enables silent mode installation.                                                                |
    | `/i`         | Specifies the path to the MSI installer file.                                                    |
    | `INSECURE=1` | Forces insecure connections, bypassing hostname verification (use only if absolutely necessary). |
    | `TOKEN=`     | Sets the Claim Token for your Netdata Cloud Space.                                               |
    | `ROOMS=`     | Comma-separated list of Room IDs where you want your node to appear.                             |
    | `PROXY=`     | Sets the proxy server address if your network requires one.                                      |
  related_resources: {}
  most_popular: true
  platform_info:
    group: ""
    distro: ""
  quick_start: 2
- id: deploy-freebsd
  meta:
    name: FreeBSD
    link: "https://www.freebsd.org/"
    categories:
      - deploy.operating-systems
    icon_filename: "freebsd.svg"
  most_popular: true
  keywords:
    - freebsd
  install_description: |
    ## Install dependencies
    Please install the following packages using the command below:

    ```pkg install bash e2fsprogs-libuuid git curl autoconf automake pkgconf pidof liblz4 libuv json-c cmake gmake```
    This step needs root privileges. Please respond in the affirmative for any relevant prompts during the installation process.

    Run the following command on your node to install and claim Netdata:
  methods:
    - *ks_curl
    - method: fetch
      commands:
        - channel: nightly
          command: >
            fetch -o /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh --nightly-channel{% if $showClaimingOptions %} --claim-token {% claim_token %} --claim-rooms {% $claim_rooms %} --claim-url {% claim_url %}{% /if %}
        - channel: stable
          command: >
            fetch -o /tmp/netdata-kickstart.sh https://get.netdata.cloud/kickstart.sh && sh /tmp/netdata-kickstart.sh --stable-channel{% if $showClaimingOptions %} --claim-token {% claim_token %} --claim-rooms {% $claim_rooms %} --claim-url {% claim_url %}{% /if %}
  additional_info: |
    Netdata can also be installed via [FreeBSD ports](https://www.freshports.org/net-mgmt/netdata).
  related_resources: {}
  platform_info:
    group: "no_include"
    distro: "freebsd"
  quick_start: 6