From 4e9a9891ba37c3d7e3769e3dfb8a1c09f3cf763c Mon Sep 17 00:00:00 2001
From: ycdtosa <ycdtosa@users.noreply.github.com>
Date: Mon, 31 Mar 2025 14:05:30 +0200
Subject: [PATCH] Update synology.md (#20010)
* Update synology.md
My previous change was not correct.
Actually the kickstart install failed to create the netdata user and group, thus it has to be created manually
* update wording
---------
Co-authored-by: ilyam8 <ilya@netdata.cloud>
---
packaging/installer/methods/synology.md | 22 ++++++++++++++--------
1 file changed, 14 insertions(+), 8 deletions(-)
diff --git a/packaging/installer/methods/synology.md b/packaging/installer/methods/synology.md
index 07f17b4307..903c00d807 100644
--- a/packaging/installer/methods/synology.md
+++ b/packaging/installer/methods/synology.md
@@ -2,28 +2,29 @@
> 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](/packaging/installer/methods/kickstart.md) works on Synology NAS devices with amd64 architecture. The script installs Netdata to `/opt/netdata/`.
-For current Synology systems (DSM 7.2.2+), the kickstart script automatically handles the complete installation process. Netdata runs as the `netdata` user and can be managed through standard systemd commands.
-
-## Older systems
-
-<details>
-<summary>For DSM versions older than 7.2.2, additional configuration is required.</summary>
+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` on older systems. To run it as the netdata user instead:
+By default, Netdata runs as `root`. To run it as the `netdata` user instead:
1. Create a `netdata` group through the Synology control panel (no special access needed)
2. 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:
+ ```sh
+ sudo synouser --add netdata <SomeGoodPassword> "netdata agent" 0 "" 0
+ sudo synogroup --add netdata netdata
+ ```
3. Set correct ownership permissions:
```bash
chown -R root:netdata /opt/netdata/usr/share/netdata
@@ -35,6 +36,11 @@ By default, Netdata runs as `root` on older systems. To run it as the netdata us
/etc/rc.netdata restart
```
+## Older systems
+
+<details>
+<summary>For DSM versions older than 7.2.2, additional configuration is required.</summary>
+
### Create a Startup Script
Older DSM versions aren't automatically recognized during installation, so you'll need to create a startup script manually: