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

Commit

Permalink
Bot Updating Templated Files
Browse files Browse the repository at this point in the history
  • Loading branch information
LinuxServer-CI committed Oct 1, 2020
1 parent e272118 commit d1f13c7
Showing 1 changed file with 20 additions and 7 deletions.
27 changes: 20 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,8 @@ Here are some example snippets to help you get started creating a container.
```
docker create \
--name=scrutiny \
--privileged \
--cap-add=SYS_ADMIN \
--cap-add=SYS_RAWIO \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=Europe/London \
Expand All @@ -72,7 +73,9 @@ docker create \
-e SCRUTINY_COLLECTOR=true \
-p 8080:8080 \
-v <path to config>:/config \
-v /dev/disk:/dev/disk:ro \
-v /dev/sda:/dev/sda:ro \
-v /dev/sdb:/dev/sdb:ro \
-v /dev/nvme1n1:/dev/nvme1n1:ro \
-v /run/udev:/run/udev:ro \
--restart unless-stopped \
linuxserver/scrutiny
Expand All @@ -90,7 +93,9 @@ services:
scrutiny:
image: linuxserver/scrutiny
container_name: scrutiny
privileged: true
cap_add:
- SYS_ADMIN
- SYS_RAWIO
environment:
- PUID=1000
- PGID=1000
Expand All @@ -100,7 +105,9 @@ services:
- SCRUTINY_COLLECTOR=true
volumes:
- <path to config>:/config
- /dev/disk:/dev/disk:ro
- /dev/sda:/dev/sda:ro
- /dev/sdb:/dev/sdb:ro
- /dev/nvme1n1:/dev/nvme1n1:ro
- /run/udev:/run/udev:ro
ports:
- 8080:8080
Expand All @@ -121,7 +128,9 @@ Container images are configured using parameters passed at runtime (such as thos
| `-e SCRUTINY_WEB=true` | # optional - Run the web service. |
| `-e SCRUTINY_COLLECTOR=true` | # optional - Run the metrics collector. |
| `-v /config` | Where config is stored. |
| `-v /dev/disk:ro` | This is how Scrutiny accesses drives. |
| `-v /dev/sda:ro` | This is how Scrutiny accesses drives. Optionally supply `/dev:/dev` instead for all devices. |
| `-v /dev/sdb:ro` | A second drive. |
| `-v /dev/nvme1n1:ro` | An NVMe drive. NVMe requires `--cap-add=SYS_RAWIO`. |
| `-v /run/udev:ro` | Provides necessary metadata to Scrutiny. |

## Environment variables from files (Docker secrets)
Expand Down Expand Up @@ -158,9 +167,13 @@ In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as bel
&nbsp;
## 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` 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.
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`).

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

A note on `--cap-add` for this container:
* `SYS_ADMIN` is necessary to allow smartctl permission to query your device SMART data.
* `SYS_RAWIO` is required for NVMe drives as per upstream issue [#26](https://github.com/AnalogJ/scrutiny/issues/26#issuecomment-696817130).


## Docker Mods
Expand Down

0 comments on commit d1f13c7

Please sign in to comment.