94 captures
10 May 2020 - 06 Feb 2026
Sep OCT Nov
28
2019 2020 2021
success
fail

About this capture

COLLECTED BY

Collection: Outlinks From Tweets

TIMESTAMPS

The Wayback Machine - http://web.archive.org/web/20201028095246/https://learn.netdata.cloud/docs/agent/packaging/installer
 

Menu
LearnDocsGuides
CommunityBlogGitHubNetdata, Inc.
🌜
🌞

Learn
Docs
Guides
Community
Blog
GitHub
Netdata, Inc.


Learn
Netdata Docs
Overview
What is Netdata?
Why use Netdata?
Use Netdata standalone or as part of your monitoring stack
Get Netdata
Quickstart
Single-node monitoring
Infrastructure monitoring
Configure
Set up Spaces and War Rooms
Invite your team and collaborate
Configure your nodes
Secure your nodes
Collect
How Netdata's metrics collectors work
Enable or configure a collector
System metrics
Container metrics
Application metrics
Supported collectors list
Visualize
See an overview of your infrastructure
Interact with dashboards and charts
Create new dashboards
Monitor
View active health alarms
Configure health alarms
Enable notifications
Store
Distributed data architecture
Change how long Netdata stores metrics
Export
Export metrics to external time-series databases
Enable an exporting connector
Reference
Agent
Agent reference docs
Get started guide
Security design
Use the Agent with Netdata Cloud
Agent-Cloud link (ACLK)
Agent claiming
Collectors
Collecting metrics
Collectors quickstart
Collectors configuration reference
Internal plugins
proc.plugin
statsd.plugin
cgroups.plugin
idlejitter.plugin
tc.plugin
checks.plugin
diskspace.plugin
freebsd.plugin
macos.plugin
External plugins
External plugins overview
Go
go.d.plugin
Modules
ActiveMQ
Apache
Bind9
CockroachDB
Consul
CoreDNS
CouchDB
Dnsmasq DHCP
DNS queries
Docker Engine
Docker Hub repositories
Elasticsearch
Files and Dirs
Fluentd
FreeRADIUS
HDFS
HTTP endpoints
ISC DHCPd
Java Spring Boot 2 applications
Kubelet
kube-proxy
Lighttpd
Lighttpd2
Logstash
MySQL
NGINX
OpenVPN
phpDaemon
PHP-FPM
Pi-hole
Prometheus endpoints
Pulsar
RabbitMQ
ScaleIO
Service discovery
Solr
Systemd units
TCP endpoints
Tengine
Unbound
vCenter Server Appliance
vCenter Servers
VerneMQ
Web server logs (Apache, NGINX)
Web server logs (Squid)
Whois domain expiry
Windows machines
x509 certificates
ZooKeeper
Python
python.d.plugin
Modules
Adaptec RAID
AM2320
Apache
Beanstalk
BOINC
CEPH
Chrony
CouchDB
DNS query RTT
Docker Engine
Dovecot
Elasticsearch
Energi Core
Example
Exim
Fail2ban
FreeRADIUS
Gearman
Go applications
HAProxy
Hard drive temperature
HP Smart Storage Arrays
HTTP endpoints
Icecast
IPFS
ISC Bind
ISC DHCP
Linux machine sensors
LiteSpeed
systemd-logind
MegaRAID controllers
Memcached
MongoDB
Monit
MySQL
NGINX
NGINX Plus
NSD
NTP daemon
Nvidia GPUs
OpenLDAP
OracleDB
OpenVPN
PHP-FPM
Postfix
PostgreSQL
PowerDNS
PowerDNS dnsdist
ProxySQL
Puppet
RabbitMQ
Redis
RethinkDB
RetroShare
Riak KV
Samba
S.M.A.R.T. attributes
SpigotMC
Java Spring Boot 2 applications
Squid
TCP endpoints
Tomcat
Tor
Traefik
uWSGI
Varnish Cache
1-Wire sensors
Web server logs (Apache, NGINX, Squid)
Node.js
node.d.plugin
Modules
Fronius Symo
ISC BIND
SMA Sunny WebBox
SNMP
Stiebel Eltron ISG
Bash
charts.d.plugin
Modules
Access points
APC UPS
Example
Libreswan IPSec tunnels
OpenSIPS
UPS/PDU
eBPF
apps.plugin
cups.plugin
fping.plugin
ioping.plugin
freeipmi.plugin
nfacct.plugin
xenstat.plugin
perf.plugin
slabinfo.plugin
Daemon/configuration
Netdata daemon
Configuration guide
Daemon configuration
Performance
Netdata for IoT
High performance Netdata
Database
Database
Database engine
Export
Reference guide
Connectors
AWS Kinesis Data Streams
Google Cloud Pub/Sub Service
MongoDB
OpenTSDB with HTTP
Prometheus remote write
Guides
Using Netdata with Prometheus
Writing metrics to TimescaleDB
Health
Health monitoring
Health quickstart
Health configuration reference
Netdata alarm notifications
Supported notifications
alerta.io
Amazon SNS
Custom
Discordapp.com
Dynatrace
Email
flock.com
Hangouts Chat
IRC
Kavenegar
Matrix
Messagebird
PagerDuty
prowl
PushBullet
PushOver
Rocket.Chat
Slack
SMS Server Tools 3
StackPulse
Syslog
Telegram
Twilio
Dashboard
HTTP API
API
Exporters
Exporters
prometheus exporter
shell exporter
Formatters
Query formatting
CSV formatter
JSON formatter
SSV formatter
Value formatter
Netdata badges
Health API Calls
Queries
Database Queries
Average or Mean
double exponential smoothing
Incremental Sum (`incremental_sum`)
Max
Median
Min
Single (or Simple) Exponential Smoothing (`ses`)
standard deviation (`stddev`)
Sum
Packaging
Installation guide
Other methods
Install Netdata with .deb/.rpm packages
Install Netdata with kickstart.sh
Install Netdata with kickstart-static64.sh
Install Netdata on a Kubernetes cluster
Install Netdata with Docker
Install Netdata on cloud providers
Install Netdata on macOS
Install Netdata on FreeBSD
Install Netdata on Linux from a Git checkout
Install Netdata on offline systems
Install Netdata on pfSense
Install Netdata on Synology
Install Netdata on FreeNAS
Install Netdata on Alpine 3.x
Netdata distribution support matrix
Update Netdata
Uninstall Netdata
Netdata static binary build
libnetdata
libnetdata
Adaptive Re-sortable List (ARL)
AVL
BUFFER
clocks
Netdata ini config files
dictionary
ebpf
eval
json
locks
log
popen
PROCFILE
Netdata simple patterns
socket
statistical
Netdata storage number
threads
url
Registry
Streaming and replication
Web
Web dashboards overview
The standard web dashboard
Custom dashboards
Atlassian Confluence dashboards
Web server
Web server
`static-threaded` web server
Running behind another web server
Running Netdata behind Nginx
Netdata via apache's mod_proxy
Netdata via lighttpd v1.4.x
Netdata via Caddy
Netdata via HAProxy
Additional information
Anonymous statistics
Netdata contrib
Testing
Health command API tester
Data structures
Cloud
Netdata Cloud reference docs
Get started with Cloud
Spaces
War Rooms
Visualizations
Overview
Nodes view
Build new dashboards
Metric Correlations
Monitor
View active alarms
Collaborate
Manage
Sign in with email, Google, or GitHub
Invite your team
FAQ and glossary
Contributing
Contributing
Contributing to documentation
Netdata style guide
Contributor Covenant Code of Conduct
Manually build Netdata from source

Installation guide


Netdata is a monitoring agent designed to run on all your systems: physical and virtual servers, containers, even IoT/edge devices. Netdata runs on Linux, FreeBSD, macOS, Kubernetes, Docker, and all their derivatives.
The best way to install Netdata is with our automatic one-line installation script, which works with all Linux distributions, or our .deb/rpm packages, which seamlessly install with your distribution's package manager.
If you want to install Netdata with Docker, on a Kubernetes cluster, or a different operating system, see Have a different operating system, or want to try another method?
Some third parties, such as the packaging teams at various Linux distributions, distribute old, broken, or altered packages. We recommend you install Netdata using one of the methods listed below to guarantee you get the latest checksum-verified packages.
Starting with v1.12, Netdata collects anonymous usage information by default and sends it to Google Analytics. Read about the information collected, and learn how to-opt, on our anonymous statistics page.
The usage statistics are vital for us, as we use them to discover bugs and prioritize new features. We thank you for actively contributing to Netdata's future.

Automatic one-line installation script

This method is fully automatic on all Linux distributions, including Ubuntu, Debian, Fedora, CentOS, and others.
To install Netdata from source, including all dependencies required to connect to Netdata Cloud, and get automatic nightly updates, run the following as your normal user:

bash <(curl -Ss https://my-netdata.io/kickstart.sh)
To see more information about this installation script, including how to disable automatic updates, get nightly vs. stable releases, or disable anonymous statistics, see the kickstart.sh method page. 
Scroll down for details about automatic updatesornightly vs. stable releases.
When you finish installing Netdata, be sure to visit our step-by-step guide for a fully-guided tour into Netdata's capabilities and how to configure it according to your needs. 
Or, if you're a monitoring and system administration pro, skip ahead to our getting started guide for a quick overview.

Have a different operating system, or want to try another method?

Netdata works on many different operating systems, each with a few possible installation methods. To see the full list of approved methods for each operating system/version we support, see our distribution matrix.
Below, you can find a few additional installation methods, followed by separate instructions for a variety of unique operating systems.

Alternative methods

Install with .deb or .rpm
packages Install with .deb or .rpm packages
Install with a pre-built static binary for 64-bit
systems Install with a pre-built static binary for 64-bit systems
Install Netdata on
Docker Install Netdata on Docker
Install Netdata on
Kubernetes Install Netdata on a Kubernetes cluster
Install Netdata on cloud providers
(GCP/AWS/Azure) Install Netdata on cloud providers (GCP/AWS/Azure)
Install Netdata on
macOS Install Netdata on macOS
Install Netdata on
FreeBSD Install Netdata on FreeBSD
Install from a Git
checkout Install from a Git checkout
Install on offline/air-gapped
systems Install on offline/air-gapped systems
Installation on
PFSense Installation on PFSense
Install Netdata on
Synology Install Netdata on Synology
Manual installation on
FreeNAS Manual installation on FreeNAS
Manual installation on
Alpine Manual installation on Alpine
Build manually from
source Build manually from source

Automatic updates

By default, Netdata's installation scripts enable automatic updates for both nightly and stable release channels.
If you would prefer to update your Netdata agent manually, you can disable automatic updates by using the --no-updates option when you install or update Netdata using the automatic one-line installation script.

bash <(curl -Ss https://my-netdata.io/kickstart.sh) --no-updates
With automatic updates disabled, you can choose exactly when and how you update Netdata.

Nightly vs. stable releases

The Netdata team maintains two releases of the Netdata agent: nightly and stable. By default, Netdata's installation scripts will give you automatic, nightly updates, as that is our recommended configuration.
Nightly: We create nightly builds every 24 hours. They contain fully-tested code that fixes bugs or security flaws, or introduces new features to Netdata. Every nightly release is a candidate for then becoming a stable releasewhen we're ready, we simply change the release tags on GitHub. That means nightly releases are stable and proven to function correctly in the vast majority of Netdata use cases. That's why nightly is the best choice for most Netdata users.
Stable: We create stable releases whenever we believe the code has reached a major milestone. Most often, stable releases correlate with the introduction of new, significant features. Stable releases might be a better choice for those who run Netdata in mission-critical production systems, as updates will come more infrequently, and only after the community helps fix any bugs that might have been introduced in previous releases.
Pros of using nightly releases:
Get the latest features and bug fixes as soon as they're available
Receive security-related fixes immediately
Use stable, fully-tested code that's always improving
Leverage the same Netdata experience our community is using
Pros of using stable releases:
Protect yourself from the rare instance when major bugs slip through our testing and negatively affect a Netdata installation
Retain more control over the Netdata version you use

Installation notes and known issues

We are tracking a few issues related to installation and packaging.

Older distributions (Ubuntu 14.04, Debian 8, CentOS 6) and OpenSSL

If you're running an older Linux distribution or one that has reached EOL, such as Ubuntu 14.04 LTS, Debian 8, or CentOS 6, your Agent may not be able to securely connect to Netdata Cloud due to an outdated version of OpenSSL. These old versions of OpenSSL cannot perform hostname validation, which helps securely encrypt SSL connections.
We recommend you reinstall Netdata with a static build, which uses an up-to-date version of OpenSSL with hostname validation enabled.
If you choose to continue using the outdated version of OpenSSL, your node will still connect to Netdata Cloud, albeit with hostname verification disabled. Without verification, your Netdata Cloud connection could be vulnerable to man-in-the-middle attacks.

CentOS 6 and CentOS 8

To install the Agent on certain CentOS and RHEL systems, you must enable non-default repositories, such as EPEL or PowerTools, to gather hard dependencies. See the CentOS 6 and CentOS 8 sections for more information.

Access to file is not permitted

If you see an error similar to Access to file is not permitted: /usr/share/netdata/web//index.html when you try to visit the Agent dashboard at http://NODE:19999, you need to update Netdata's permissions to match those of your system.
Run ls -la /usr/share/netdata/web/index.html to find the file's permissions. You may need to change this path based on the error you're seeing in your browser. In the below example, the file is owned by the user netdata and the group netdata.

ls -la /usr/share/netdata/web/index.html
-rw-r--r--. 1netdata netdata 89377 May 506:30 /usr/share/netdata/web/index.html
Open your netdata.conf file and find the [web] section, plus the web files owner/web files group settings. Edit the lines to match the output from ls -la above and uncomment them if necessary.

[web]
 web files owner = netdata
 web files group = netdata
Save the file, restart the Netdata Agent, and try accessing the dashboard again.

Multiple versions of OpenSSL

We've received reports from the community about issues with running the kickstart.sh script on systems that have both a distribution-installed version of OpenSSL and a manually-installed local version. The Agent's installer cannot handle both.
We recommend you install Netdata with the static binary to avoid the issue altogether. Or, you can manually remove one version of OpenSSL to remove the conflict.

Clang compiler on Linux

Our current build process has some issues when using certain configurations of the clang C compiler on Linux. See the section on nonrepresentable section on output errors for a workaround.

Edit this page
Last updated on 


Previous
« Sum

Next
Install Netdata with .deb/.rpm packages »
Contents
Automatic one-line installation script
Have a different operating system, or want to try another method?
Alternative methods
Automatic updates
Nightly vs. stable releases
Installation notes and known issues
Older distributions (Ubuntu 14.04, Debian 8, CentOS 6) and OpenSSL
CentOS 6 and CentOS 8
Access to file is not permitted
Multiple versions of OpenSSL
Clang compiler on Linux
Edit this page

Agent
Cloud
Integrations
Status
Learn
Blog
GitHub
Overview
Forums
About
News
Careers
Copyright © 2020 Netdata, Inc. Built with Docusaurus.