From 65b3adf0116cda262eba518fca14176782cc1259 Mon Sep 17 00:00:00 2001 From: LinuxServer-CI Date: Sat, 19 Sep 2020 13:56:19 +0000 Subject: [PATCH] Bot Updating Documentation --- images/docker-scrutiny.md | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) diff --git a/images/docker-scrutiny.md b/images/docker-scrutiny.md index b460689bc..81cc865ce 100755 --- a/images/docker-scrutiny.md +++ b/images/docker-scrutiny.md @@ -10,7 +10,7 @@ [![Jenkins Build](https://img.shields.io/jenkins/build?labelColor=555555&logoColor=ffffff&style=for-the-badge&jobUrl=https%3A%2F%2Fci.linuxserver.io%2Fjob%2FDocker-Pipeline-Builders%2Fjob%2Fdocker-scrutiny%2Fjob%2Fmaster%2F&logo=jenkins)](https://ci.linuxserver.io/job/Docker-Pipeline-Builders/job/docker-scrutiny/job/master/) [![LSIO CI](https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=CI&query=CI&url=https%3A%2F%2Flsio-ci.ams3.digitaloceanspaces.com%2Flinuxserver%2Fscrutiny%2Flatest%2Fci-status.yml)](https://lsio-ci.ams3.digitaloceanspaces.com/linuxserver/scrutiny/latest/index.html) -[Scrutiny](https://github.com/AnalogJ/scrutiny) WebUI for smartd S.M.A.R.T monitoring. +[Scrutiny](https://github.com/AnalogJ/scrutiny) WebUI for smartd S.M.A.R.T monitoring. Scrutiny is a Hard Drive Health Dashboard & Monitoring solution, merging manufacturer provided S.M.A.R.T metrics with real-world failure rates from Backblaze. ## Supported Architectures @@ -36,6 +36,7 @@ Here are some example snippets to help you get started creating a container from ``` docker create \ --name=scrutiny \ + --privileged \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ @@ -44,6 +45,8 @@ docker create \ -e SCRUTINY_COLLECTOR=true \ -p 8080:8080 \ -v :/config \ + -v /dev/disk:/dev/disk \ + -v /run/udev:ro:/run/udev \ --restart unless-stopped \ linuxserver/scrutiny ``` @@ -60,6 +63,7 @@ services: scrutiny: image: linuxserver/scrutiny container_name: scrutiny + privileged: true environment: - PUID=1000 - PGID=1000 @@ -69,6 +73,8 @@ services: - SCRUTINY_COLLECTOR=true volumes: - :/config + - /dev/disk:/dev/disk + - /run/udev:ro:/run/udev ports: - 8080:8080 restart: unless-stopped @@ -92,15 +98,17 @@ Docker images are configured using parameters passed at runtime (such as those a | `PUID=1000` | for UserID - see below for explanation | | `PGID=1000` | for GroupID - see below for explanation | | `TZ=Europe/London` | Specify a timezone to use EG Europe/London. | -| `SCRUTINY_API_ENDPOINT=http://localhost:8080` | (optional) API endpoint of the scrutiny UI. | -| `SCRUTINY_WEB=true` | (optional) Run the web service. | -| `SCRUTINY_COLLECTOR=true` | (optional) Run the metrics collector. | +| `SCRUTINY_API_ENDPOINT=http://localhost:8080` | # optional - API endpoint of the scrutiny UI. | +| `SCRUTINY_WEB=true` | # optional - Run the web service. | +| `SCRUTINY_COLLECTOR=true` | # optional - Run the metrics collector. | ### Volume Mappings (`-v`) | Volume | Function | | :----: | --- | -| `/config` | Where scrutiny config is stored. | +| `/config` | Where config is stored. | +| `/dev/disk` | This is how Scrutiny accesses drives. | +| `/run/udev` | Provides necessary metadata to Scrutiny. | @@ -137,9 +145,9 @@ In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as bel ## Application Setup -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` control which mode the containe will run in. Setting both to `true` will deploy the container as both a collector and the web UI / "Port for scrutiny's web interface and API." +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. -You can deploy the same container on multiple hosts running only the collector by specifying the `SCRUTINY_API_ENDPOINT` to point to the host that is running the API. +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`). ## Docker Mods