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.
The ARM variants can be built on x86_64 hardware using `multiarch/qemu-user-static`
109
-
```
109
+
110
+
```bash
110
111
docker run --rm --privileged multiarch/qemu-user-static:register --reset
111
112
```
112
113
113
114
Once registered you can define the dockerfile to use with `-f Dockerfile.aarch64`.
114
115
115
-
## Update the chagelog
116
+
## Update the changelog
116
117
117
118
If you are modifying the Dockerfiles or any of the startup scripts in [root](https://github.com/linuxserver/docker-scrutiny/tree/master/root), add an entry to the changelog
The [LinuxServer.io](https://linuxserver.io) team brings you another container release featuring:
14
14
15
-
* regular and timely application updates
16
-
* easy user mappings (PGID, PUID)
17
-
* custom base image with s6 overlay
18
-
* weekly base OS updates with common layers across the entire LinuxServer.io ecosystem to minimise space usage, down time and bandwidth
19
-
* regular security updates
15
+
* regular and timely application updates
16
+
* easy user mappings (PGID, PUID)
17
+
* custom base image with s6 overlay
18
+
* weekly base OS updates with common layers across the entire LinuxServer.io ecosystem to minimise space usage, down time and bandwidth
19
+
* regular security updates
20
20
21
21
Find us at:
22
+
22
23
*[Blog](https://blog.linuxserver.io) - all the things you can do with our containers including How-To guides, opinions and much more!
23
24
*[Discord](https://discord.gg/YWrKVTn) - realtime support / chat with the community and the team.
24
25
*[Discourse](https://discourse.linuxserver.io) - post on our community forum.
@@ -56,6 +57,17 @@ The architectures supported by this image are:
56
57
| arm64 | arm64v8-latest |
57
58
| armhf | arm32v7-latest |
58
59
60
+
## Application Setup
61
+
62
+
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`).
63
+
64
+
You may need to manually enter the container to run `scrutiny-collector-metrics run` for your first job or wait until around midnight for it to kick off.
65
+
66
+
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`.
67
+
68
+
A note on `--cap-add` for this container:
69
+
*`SYS_RAWIO` is necessary to allow smartctl permission to query your device SMART data.
70
+
*`SYS_ADMIN` is required for NVMe drives as per upstream issue [#26](https://github.com/AnalogJ/scrutiny/issues/26#issuecomment-696817130).
59
71
60
72
## Usage
61
73
@@ -96,7 +108,7 @@ services:
96
108
97
109
### docker cli
98
110
99
-
```
111
+
```bash
100
112
docker run -d \
101
113
--name=scrutiny \
102
114
--cap-add=SYS_RAWIO \
@@ -117,7 +129,6 @@ docker run -d \
117
129
ghcr.io/linuxserver/scrutiny
118
130
```
119
131
120
-
121
132
## Parameters
122
133
123
134
Container images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `<external>:<internal>` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.
@@ -143,7 +154,7 @@ You can set any environment variable from a file by using a special prepend `FIL
143
154
144
155
As an example:
145
156
146
-
```
157
+
```bash
147
158
-e FILE__PASSWORD=/run/secrets/mysecretpassword
148
159
```
149
160
@@ -162,32 +173,17 @@ Ensure any volume directories on the host are owned by the same user you specify
162
173
163
174
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as below:
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`).
175
-
176
-
You may need to manually enter the container to run `scrutiny-collector-metrics run` for your first job or wait until around midnight for it to kick off.
177
-
178
-
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`.
179
-
180
-
A note on `--cap-add` for this container:
181
-
*`SYS_RAWIO` is necessary to allow smartctl permission to query your device SMART data.
182
-
*`SYS_ADMIN` is required for NVMe drives as per upstream issue [#26](https://github.com/AnalogJ/scrutiny/issues/26#issuecomment-696817130).
183
-
184
-
185
181
## Docker Mods
182
+
186
183
[](https://mods.linuxserver.io/?mod=scrutiny"view available mods for this container.")[](https://mods.linuxserver.io/?mod=universal"view available universal mods.")
187
184
188
185
We publish various [Docker Mods](https://github.com/linuxserver/docker-mods) to enable additional functionality within the containers. The list of Mods available for this image (if any) as well as universal mods that can be applied to any one of our images can be accessed via the dynamic badges above.
189
186
190
-
191
187
## Support Info
192
188
193
189
* Shell access whilst the container is running: `docker exec -it scrutiny /bin/bash`
@@ -204,38 +200,45 @@ Most of our images are static, versioned, and require an image update and contai
204
200
Below are the instructions for updating containers:
205
201
206
202
### Via Docker Compose
203
+
207
204
* Update all images: `docker-compose pull`
208
205
* or update a single image: `docker-compose pull scrutiny`
209
206
* Let compose update all containers as necessary: `docker-compose up -d`
210
207
* or update a single container: `docker-compose up -d scrutiny`
211
208
* You can also remove the old dangling images: `docker image prune`
212
209
213
210
### Via Docker Run
211
+
214
212
* Update the image: `docker pull ghcr.io/linuxserver/scrutiny`
215
213
* Stop the running container: `docker stop scrutiny`
216
214
* Delete the container: `docker rm scrutiny`
217
215
* Recreate a new container with the same docker run parameters as instructed above (if mapped correctly to a host folder, your `/config` folder and settings will be preserved)
218
216
* You can also remove the old dangling images: `docker image prune`
219
217
220
218
### Via Watchtower auto-updater (only use if you don't remember the original parameters)
219
+
221
220
* Pull the latest image at its tag and replace it with the same env variables in one run:
222
-
```
221
+
222
+
```bash
223
223
docker run --rm \
224
224
-v /var/run/docker.sock:/var/run/docker.sock \
225
225
containrrr/watchtower \
226
226
--run-once scrutiny
227
227
```
228
+
228
229
* You can also remove the old dangling images: `docker image prune`
229
230
230
231
**Note:** We do not endorse the use of Watchtower as a solution to automated updates of existing Docker containers. In fact we generally discourage automated updates. However, this is a useful tool for one-time manual updates of containers where you have forgotten the original parameters. In the long term, we highly recommend using [Docker Compose](https://docs.linuxserver.io/general/docker-compose).
* We recommend [Diun](https://crazymax.dev/diun/) for update notifications. Other tools that automatically update containers unattended are not recommended or supported.
234
236
235
237
## Building locally
236
238
237
239
If you want to make local modifications to these images for development purposes or just to customize the logic:
0 commit comments