docs: remove prereq install smartmontools in Docker (#21413)
Ilya Mashchenko committed
Dec 5, 2025 at 22:24 UTC
38067ac0b680ea303622b37a6e407aac4ff288fc
1 file changed
+19
-23
src/go/plugin/go.d/collector/smartctl/metadata.yaml
+19
-23
@@ -54,36 +54,32 @@ modules:
54
Install `smartmontools` version 7.0 or later using your distribution's package manager. Version 7.0 introduced the `--json` output mode, which is required for this collector to function properly.
55
- title: For Netdata running in a Docker container
56
description: |
57
- 1. **Install smartmontools**.
57
+ **Provide access to storage devices**.
58
59
- Ensure `smartctl` is available in the container by setting the environment variable `NETDATA_EXTRA_DEB_PACKAGES=smartmontools` when starting the container.
59
+ Netdata requires the `SYS_RAWIO` capability and access to the storage devices to run the `smartctl` collector inside a Docker container. Here's how you can achieve this:
60
61
- 2. **Provide access to storage devices**.
61
+ - `docker run`
62
63
- Netdata requires the `SYS_RAWIO` capability and access to the storage devices to run the `smartctl` collector inside a Docker container. Here's how you can achieve this:
63
+ ```bash
64
+ docker run --cap-add SYS_RAWIO --device /dev/sda:/dev/sda ...
65
+ ```
66
65
- - `docker run`
67
+ - `docker-compose.yml`
68
67
- ```bash
68
- docker run --cap-add SYS_RAWIO --device /dev/sda:/dev/sda ...
69
- ```
69
+ ```yaml
70
+ services:
71
+ netdata:
72
+ cap_add:
73
+ - SYS_PTRACE
74
+ - SYS_ADMIN
75
+ - SYS_RAWIO # smartctl
76
+ devices:
77
+ - "/dev/sda:/dev/sda"
78
+ ```
79
71
- - `docker-compose.yml`
80
+ > **Multiple Devices**: These examples only show mapping of one device (/dev/sda). You'll need to add additional `--device` options (in docker run) or entries in the `devices` list (in docker-compose.yml) for each storage device you want Netdata's smartctl collector to monitor.
81
73
- ```yaml
74
- services:
75
- netdata:
76
- cap_add:
77
- - SYS_PTRACE
78
- - SYS_ADMIN
79
- - SYS_RAWIO # smartctl
80
- devices:
81
- - "/dev/sda:/dev/sda"
82
- ```
83
-
84
- > **Multiple Devices**: These examples only show mapping of one device (/dev/sda). You'll need to add additional `--device` options (in docker run) or entries in the `devices` list (in docker-compose.yml) for each storage device you want Netdata's smartctl collector to monitor.
85
-
86
- > **NVMe Devices**: Do not map NVMe devices using this method. Netdata uses a [dedicated collector](https://github.com/netdata/netdata/tree/master/src/go/plugin/go.d/collector/nvme#readme) to monitor NVMe devices.
82
+ > **NVMe Devices**: Do not map NVMe devices using this method. Netdata uses a [dedicated collector](https://github.com/netdata/netdata/tree/master/src/go/plugin/go.d/collector/nvme#readme) to monitor NVMe devices.
83
configuration:
84
file:
85
name: go.d/smartctl.conf