Skip to content
This repository was archived by the owner on Jan 1, 2024. It is now read-only.

Commit 0dc17de

Browse files
Bot Updating Templated Files
1 parent 0a577fe commit 0dc17de

File tree

2 files changed

+31
-26
lines changed

2 files changed

+31
-26
lines changed

.github/CONTRIBUTING.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ If you are proposing additional packages to be added, ensure that you added the
9696

9797
### Testing your changes
9898

99-
```
99+
```bash
100100
git clone https://github.com/linuxserver/docker-domoticz.git
101101
cd docker-domoticz
102102
docker build \
@@ -106,13 +106,14 @@ docker build \
106106
```
107107

108108
The ARM variants can be built on x86_64 hardware using `multiarch/qemu-user-static`
109-
```
109+
110+
```bash
110111
docker run --rm --privileged multiarch/qemu-user-static:register --reset
111112
```
112113

113114
Once registered you can define the dockerfile to use with `-f Dockerfile.aarch64`.
114115

115-
## Update the chagelog
116+
## Update the changelog
116117

117118
If you are modifying the Dockerfiles or any of the startup scripts in [root](https://github.com/linuxserver/docker-domoticz/tree/master/root), add an entry to the changelog
118119

README.md

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!-- DO NOT EDIT THIS FILE MANUALLY -->
2-
<!-- Please read the CONTRIBUTING.md -->
2+
<!-- Please read the https://github.com/linuxserver/docker-domoticz/blob/master/.github/CONTRIBUTING.md -->
33

44
[![linuxserver.io](https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png)](https://linuxserver.io)
55

@@ -12,13 +12,14 @@
1212

1313
The [LinuxServer.io](https://linuxserver.io) team brings you another container release featuring:
1414

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
2020

2121
Find us at:
22+
2223
* [Blog](https://blog.linuxserver.io) - all the things you can do with our containers including How-To guides, opinions and much more!
2324
* [Discord](https://discord.gg/YWrKVTn) - realtime support / chat with the community and the team.
2425
* [Discourse](https://discourse.linuxserver.io) - post on our community forum.
@@ -39,7 +40,6 @@ Find us at:
3940
[![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%2Fci-tests.linuxserver.io%2Flinuxserver%2Fdomoticz%2Flatest%2Fci-status.yml)](https://ci-tests.linuxserver.io/linuxserver/domoticz/latest/index.html)
4041

4142
[Domoticz](https://www.domoticz.com) is a Home Automation System that lets you monitor and configure various devices like: Lights, Switches, various sensors/meters like Temperature, Rain, Wind, UV, Electra, Gas, Water and much more. Notifications/Alerts can be sent to any mobile device.
42-
4343
[![domoticz](https://github.com/domoticz/domoticz/raw/master/www/images/logo.png)](https://www.domoticz.com)
4444

4545
## Supported Architectures
@@ -68,6 +68,11 @@ This image provides various versions that are available via tags. `latest` tag u
6868
| stable-3.815 | Old stable version. Will not be updated anymore! |
6969
| stable-3.5877 | Old stable version. Will not be updated anymore! |
7070

71+
## Application Setup
72+
73+
To configure Domoticz, go to the IP of your docker host on the port you configured (default 8080), and add your hardware in Setup > Hardware.
74+
The user manual is available at [www.domoticz.com](https://www.domoticz.com)
75+
7176
## Usage
7277

7378
Here are some example snippets to help you get started creating a container.
@@ -101,7 +106,7 @@ services:
101106
102107
### docker cli
103108
104-
```
109+
```bash
105110
docker run -d \
106111
--name=domoticz \
107112
-e PUID=1000 \
@@ -129,7 +134,6 @@ usb 1-1.2: FTDI USB Serial Device converter now attached to ttyUSB0
129134
```
130135
As you can see above, the device node created is ttyUSB0. It does not say where, but it's almost always in /dev/. The correct tag for passing through this USB device is '--device /dev/ttyUSB0:/dev/ttyUSB0'
131136

132-
133137
## Parameters
134138

135139
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.
@@ -152,7 +156,7 @@ You can set any environment variable from a file by using a special prepend `FIL
152156

153157
As an example:
154158

155-
```
159+
```bash
156160
-e FILE__PASSWORD=/run/secrets/mysecretpassword
157161
```
158162

@@ -171,25 +175,17 @@ Ensure any volume directories on the host are owned by the same user you specify
171175

172176
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as below:
173177

174-
```
178+
```bash
175179
$ id username
176180
uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
177181
```
178182

179-
180-
&nbsp;
181-
## Application Setup
182-
183-
To configure Domoticz, go to the IP of your docker host on the port you configured (default 8080), and add your hardware in Setup > Hardware.
184-
The user manual is available at [www.domoticz.com](https://www.domoticz.com)
185-
186-
187183
## Docker Mods
184+
188185
[![Docker Mods](https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=domoticz&query=%24.mods%5B%27domoticz%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml)](https://mods.linuxserver.io/?mod=domoticz "view available mods for this container.") [![Docker Universal Mods](https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml)](https://mods.linuxserver.io/?mod=universal "view available universal mods.")
189186

190187
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.
191188

192-
193189
## Support Info
194190

195191
* Shell access whilst the container is running: `docker exec -it domoticz /bin/bash`
@@ -206,38 +202,45 @@ Most of our images are static, versioned, and require an image update and contai
206202
Below are the instructions for updating containers:
207203

208204
### Via Docker Compose
205+
209206
* Update all images: `docker-compose pull`
210207
* or update a single image: `docker-compose pull domoticz`
211208
* Let compose update all containers as necessary: `docker-compose up -d`
212209
* or update a single container: `docker-compose up -d domoticz`
213210
* You can also remove the old dangling images: `docker image prune`
214211

215212
### Via Docker Run
213+
216214
* Update the image: `docker pull ghcr.io/linuxserver/domoticz`
217215
* Stop the running container: `docker stop domoticz`
218216
* Delete the container: `docker rm domoticz`
219217
* 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)
220218
* You can also remove the old dangling images: `docker image prune`
221219

222220
### Via Watchtower auto-updater (only use if you don't remember the original parameters)
221+
223222
* Pull the latest image at its tag and replace it with the same env variables in one run:
224-
```
223+
224+
```bash
225225
docker run --rm \
226226
-v /var/run/docker.sock:/var/run/docker.sock \
227227
containrrr/watchtower \
228228
--run-once domoticz
229229
```
230+
230231
* You can also remove the old dangling images: `docker image prune`
231232

232233
**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).
233234

234235
### Image Update Notifications - Diun (Docker Image Update Notifier)
236+
235237
* We recommend [Diun](https://crazymax.dev/diun/) for update notifications. Other tools that automatically update containers unattended are not recommended or supported.
236238

237239
## Building locally
238240

239241
If you want to make local modifications to these images for development purposes or just to customize the logic:
240-
```
242+
243+
```bash
241244
git clone https://github.com/linuxserver/docker-domoticz.git
242245
cd docker-domoticz
243246
docker build \
@@ -247,7 +250,8 @@ docker build \
247250
```
248251

249252
The ARM variants can be built on x86_64 hardware using `multiarch/qemu-user-static`
250-
```
253+
254+
```bash
251255
docker run --rm --privileged multiarch/qemu-user-static:register --reset
252256
```
253257

0 commit comments

Comments
 (0)