Install Netdata on Synology
This community-maintained guide may not reflect the latest changes. Please verify the installation steps before proceeding.
Help improve this guide by submitting a PR with your suggestions. Thank you!
The one-line installation script works on Synology NAS devices with amd64 architecture. The script installs Netdata to /opt/netdata/
.
On current Synology systems (DSM 7.2.2+), the kickstart script automates the entire installation process but doesn't create the necessary netdata
user and group. As a result, Netdata operates with root privileges instead. Once installed, it can be controlled using standard systemd commands.
Run as netdata user
By default, Netdata runs as root
. To run it as the netdata
user instead:
Create a
netdata
group through the Synology control panel (no special access needed)Create a
netdata
user through the Synology control panel:- Assign it to the netdata group
- Set a random password
- Grant no access permission
or alternatively from the CLI:
sudo synouser --add netdata <SomeGoodPassword> "netdata agent" 0 "" 0
sudo synogroup --add netdata netdataSet correct ownership permissions:
chown -R root:netdata /opt/netdata/usr/share/netdata
chown -R netdata:netdata /opt/netdata/var/lib/netdata /opt/netdata/var/cache/netdata
chown -R netdata:root /opt/netdata/var/log/netdataRestart Netdata
/etc/rc.netdata restart
Older systems
For DSM versions older than 7.2.2, additional configuration is required.
Create a Startup Script
Older DSM versions aren't automatically recognized during installation, so you'll need to create a startup script manually:
- Create
/etc/rc.netdata
with this script. - Make it executable:
chmod 0755 /etc/rc.netdata
- Enable auto-start by adding to
/etc/rc.local
:# Netdata startup
[ -x /etc/rc.netdata ] && /etc/rc.netdata start
Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.