You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jun 15, 2022. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+20-7
Original file line number
Diff line number
Diff line change
@@ -63,7 +63,8 @@ Here are some example snippets to help you get started creating a container.
63
63
```
64
64
docker create \
65
65
--name=scrutiny \
66
-
--privileged \
66
+
--cap-add=SYS_ADMIN \
67
+
--cap-add=SYS_RAWIO \
67
68
-e PUID=1000 \
68
69
-e PGID=1000 \
69
70
-e TZ=Europe/London \
@@ -72,7 +73,9 @@ docker create \
72
73
-e SCRUTINY_COLLECTOR=true \
73
74
-p 8080:8080 \
74
75
-v <path to config>:/config \
75
-
-v /dev/disk:/dev/disk:ro \
76
+
-v /dev/sda:/dev/sda:ro \
77
+
-v /dev/sdb:/dev/sdb:ro \
78
+
-v /dev/nvme1n1:/dev/nvme1n1:ro \
76
79
-v /run/udev:/run/udev:ro \
77
80
--restart unless-stopped \
78
81
linuxserver/scrutiny
@@ -90,7 +93,9 @@ services:
90
93
scrutiny:
91
94
image: linuxserver/scrutiny
92
95
container_name: scrutiny
93
-
privileged: true
96
+
cap_add:
97
+
- SYS_ADMIN
98
+
- SYS_RAWIO
94
99
environment:
95
100
- PUID=1000
96
101
- PGID=1000
@@ -100,7 +105,9 @@ services:
100
105
- SCRUTINY_COLLECTOR=true
101
106
volumes:
102
107
- <path to config>:/config
103
-
- /dev/disk:/dev/disk:ro
108
+
- /dev/sda:/dev/sda:ro
109
+
- /dev/sdb:/dev/sdb:ro
110
+
- /dev/nvme1n1:/dev/nvme1n1:ro
104
111
- /run/udev:/run/udev:ro
105
112
ports:
106
113
- 8080:8080
@@ -121,7 +128,9 @@ Container images are configured using parameters passed at runtime (such as thos
121
128
|`-e SCRUTINY_WEB=true`| # optional - Run the web service. |
122
129
|`-e SCRUTINY_COLLECTOR=true`| # optional - Run the metrics collector. |
123
130
|`-v /config`| Where config is stored. |
124
-
|`-v /dev/disk:ro`| This is how Scrutiny accesses drives. |
131
+
|`-v /dev/sda:ro`| This is how Scrutiny accesses drives. Optionally supply `/dev:/dev` instead for all devices. |
132
+
|`-v /dev/sdb:ro`| A second drive. |
133
+
|`-v /dev/nvme1n1:ro`| An NVMe drive. NVMe requires `--cap-add=SYS_RAWIO`. |
125
134
|`-v /run/udev:ro`| Provides necessary metadata to Scrutiny. |
126
135
127
136
## Environment variables from files (Docker secrets)
@@ -158,9 +167,13 @@ In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as bel
158
167
159
168
## Application Setup
160
169
161
-
This container can be run as an 'all-in-one' deployment or as a hub / spoke deployment. Use the environment variables `SCRUTINY_WEB` and `SCRUTINY_COLLECTOR` to control the mode of the container. Setting both to `true` will deploy the container as both a collector and the web UI - this is the simplest and most straightforward deployment approach.
170
+
This container can be run as an 'all-in-one' deployment or as a hub / spoke deployment. Use the environment variables `SCRUTINY_WEB` and `SCRUTINY_COLLECTOR` to control the mode of the container. Setting both to `true` will deploy the container as both a collector and the web UI - this is the simplest and most straightforward deployment approach. To make use of the hub and spoke model, run this container in "collector" mode by specifying `SCRUTINY_API_ENDPOINT`. Set this to the host that is running the API. For this to work, you will need to expose the API port directly from the container (by default this is `8080`).
162
171
163
-
To make use of the hub and spoke model, run this container in "collector" mode by specifying `SCRUTINY_API_ENDPOINT`. Set this to the host that is running the API. For this to work, you will need to expose the API port directly from the container (by default this is `8080`).
172
+
A fully commented example configuration yaml file can be found in the original project repository [here](https://github.com/AnalogJ/scrutiny/blob/master/example.scrutiny.yaml). Place this file in the location mounted to `/config`.
173
+
174
+
A note on `--cap-add` for this container:
175
+
*`SYS_ADMIN` is necessary to allow smartctl permission to query your device SMART data.
176
+
*`SYS_RAWIO` is required for NVMe drives as per upstream issue [#26](https://github.com/AnalogJ/scrutiny/issues/26#issuecomment-696817130).
0 commit comments