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>
ycdtosa committed
Mar 31, 2025 at 14:05 UTC
4e9a9891ba37c3d7e3769e3dfb8a1c09f3cf763c
1 file changed
+14
-8
packaging/installer/methods/synology.md
+14
-8
@@ -2,28 +2,29 @@
2
3
> This community-maintained guide may not reflect the latest changes.
4
> Please verify the installation steps before proceeding.
5
->
5
+>
6
> Help improve this guide by submitting a PR with your suggestions.
7
> Thank you!
8
9
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/`.
10
11
-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.
12
-
13
-## Older systems
14
-
15
-<details>
16
-<summary>For DSM versions older than 7.2.2, additional configuration is required.</summary>
11
+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.
12
13
### Run as netdata user
14
20
-By default, Netdata runs as `root` on older systems. To run it as the netdata user instead:
15
+By default, Netdata runs as `root`. To run it as the `netdata` user instead:
16
17
1. Create a `netdata` group through the Synology control panel (no special access needed)
18
2. Create a `netdata` user through the Synology control panel:
19
- Assign it to the netdata group
20
- Set a random password
21
- Grant no access permission
22
+
23
+ or alternatively from the CLI:
24
+ ```sh
25
+ sudo synouser --add netdata <SomeGoodPassword> "netdata agent" 0 "" 0
26
+ sudo synogroup --add netdata netdata
27
+ ```
28
3. Set correct ownership permissions:
29
```bash
30
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
36
/etc/rc.netdata restart
37
```
38
39
+## Older systems
40
+
41
+<details>
42
+<summary>For DSM versions older than 7.2.2, additional configuration is required.</summary>
43
+
44
### Create a Startup Script
45
46
Older DSM versions aren't automatically recognized during installation, so you'll need to create a startup script manually: