Skip to content
This repository was archived by the owner on Jun 15, 2022. It is now read-only.

Commit d1f13c7

Browse files
Bot Updating Templated Files
1 parent e272118 commit d1f13c7

File tree

1 file changed

+20
-7
lines changed

1 file changed

+20
-7
lines changed

README.md

+20-7
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,8 @@ Here are some example snippets to help you get started creating a container.
6363
```
6464
docker create \
6565
--name=scrutiny \
66-
--privileged \
66+
--cap-add=SYS_ADMIN \
67+
--cap-add=SYS_RAWIO \
6768
-e PUID=1000 \
6869
-e PGID=1000 \
6970
-e TZ=Europe/London \
@@ -72,7 +73,9 @@ docker create \
7273
-e SCRUTINY_COLLECTOR=true \
7374
-p 8080:8080 \
7475
-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 \
7679
-v /run/udev:/run/udev:ro \
7780
--restart unless-stopped \
7881
linuxserver/scrutiny
@@ -90,7 +93,9 @@ services:
9093
scrutiny:
9194
image: linuxserver/scrutiny
9295
container_name: scrutiny
93-
privileged: true
96+
cap_add:
97+
- SYS_ADMIN
98+
- SYS_RAWIO
9499
environment:
95100
- PUID=1000
96101
- PGID=1000
@@ -100,7 +105,9 @@ services:
100105
- SCRUTINY_COLLECTOR=true
101106
volumes:
102107
- <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
104111
- /run/udev:/run/udev:ro
105112
ports:
106113
- 8080:8080
@@ -121,7 +128,9 @@ Container images are configured using parameters passed at runtime (such as thos
121128
| `-e SCRUTINY_WEB=true` | # optional - Run the web service. |
122129
| `-e SCRUTINY_COLLECTOR=true` | # optional - Run the metrics collector. |
123130
| `-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`. |
125134
| `-v /run/udev:ro` | Provides necessary metadata to Scrutiny. |
126135

127136
## 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
158167
&nbsp;
159168
## Application Setup
160169

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`).
162171

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).
164177

165178

166179
## Docker Mods

0 commit comments

Comments
 (0)