mirror of
https://github.com/netdata/netdata.git
synced 2025-04-29 07:00:01 +00:00
4e9a9891ba
* 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>
59 lines
2.1 KiB
Markdown
59 lines
2.1 KiB
Markdown
# 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](/packaging/installer/methods/kickstart.md) 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:
|
|
|
|
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
|
|
chown -R netdata:netdata /opt/netdata/var/lib/netdata /opt/netdata/var/cache/netdata
|
|
chown -R netdata:root /opt/netdata/var/log/netdata
|
|
````
|
|
4. Restart Netdata
|
|
```sh
|
|
/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:
|
|
|
|
1. Create `/etc/rc.netdata` with [this script](https://gist.github.com/oskapt/055d474d7bfef32c49469c1b53e8225f).
|
|
2. Make it executable:
|
|
```sh
|
|
chmod 0755 /etc/rc.netdata
|
|
```
|
|
3. Enable auto-start by adding to `/etc/rc.local`:
|
|
```sh
|
|
# Netdata startup
|
|
[ -x /etc/rc.netdata ] && /etc/rc.netdata start
|
|
```
|
|
|
|
</details>
|