- &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 claim Netdata:" 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 \ --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 \ --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 {% 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 {% 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 {% 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 {% 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