summaryrefslogtreecommitdiffstats
path: root/debian/netdata-core.README.Debian
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-27 11:08:08 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-27 11:08:08 +0000
commitba729bd1d3089ba48b57ff6cab7e4ca21ccb4146 (patch)
tree156030137bdda66d88a8ae3d033ecf55d1c141da /debian/netdata-core.README.Debian
parentAdding upstream version 1.29.3. (diff)
downloadnetdata-ba729bd1d3089ba48b57ff6cab7e4ca21ccb4146.tar.xz
netdata-ba729bd1d3089ba48b57ff6cab7e4ca21ccb4146.zip
Adding debian version 1.29.3-4.debian/1.29.3-4debian
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'debian/netdata-core.README.Debian')
-rw-r--r--debian/netdata-core.README.Debian43
1 files changed, 43 insertions, 0 deletions
diff --git a/debian/netdata-core.README.Debian b/debian/netdata-core.README.Debian
new file mode 100644
index 0000000..8f1ab85
--- /dev/null
+++ b/debian/netdata-core.README.Debian
@@ -0,0 +1,43 @@
+netdata for Debian
+==================
+
+1. Web UI
+---------
+
+If you install netdata-web, the web UI will be available by default on
+http://localhost:19999
+
+
+2. Plugins
+----------
+
+netdata has a lot of plugins. Some of them need extra configuration on the
+host system to work. Here are some notes for that...
+
+2.1 mysql/mariadb
+-----------------
+
+netdata by default tries to read /etc/mysql/debian.cnf and use the
+debian-sys-maint credentials to access the database.
+
+For Debian 10 and older, you *could* (but shouldn't, see below) grant netdata
+access to debian.cnf by setting the group ownership to netdata.
+
+For Debian 11 and newer, the debian.cnf is no longer used.
+
+Instead (and preferably also for Debian 10 and older), a dedicated read-only
+database user should be created:
+
+ $ sudo mariadb -u root
+ MariaDB > create user 'netdata'@'localhost';
+ MariaDB > grant usage on *.* to 'netdata'@'localhost';
+ MariaDB > flush privileges;
+ MariaDB > exit
+
+Note that this will allow the netdata to connect to mariadb but *not* read
+any data (which it does not need to).
+
+Naming the user 'netdata' saves you from configuring anything in netdata itself
+and it will automatically pick it up once the user has been created.
+
+ -- Daniel Baumann <daniel.baumann@progress-linux.org> Tue, 09 Feb 2021 11:03:31 +0100