From 66ddc596c9f7574008a8ea722dcb0811a46adfb0 Mon Sep 17 00:00:00 2001 From: Andre Date: Sun, 16 Feb 2020 17:20:50 +0100 Subject: [PATCH 1/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 41cc034..e9a3573 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,7 @@ The following ways to geht iobroker-container running are only examples. Maybe y For taking a first look at the iobroker docker container it would be enough to simply run the following basic docker run command: ``` -docker run -p 8081:8081 --name iobroker -v /opt/iobroker:/iobroker buanet/iobroker:latest +docker run -p 8081:8081 --name iobroker -v iobrokerdata:/opt/iobroker buanet/iobroker:latest ``` ### Running with docker-compose From 2838cda01687d6c5bea153996280fef438e2ab65 Mon Sep 17 00:00:00 2001 From: Andre Date: Thu, 16 Apr 2020 11:37:23 +0200 Subject: [PATCH 2/8] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index eb21684..36b043a 100644 --- a/README.md +++ b/README.md @@ -211,7 +211,7 @@ Thank you! ### v1.2.0 (2018-08-21) * v1.1.3beta (2018-08-21) - * added ffmpeg-package for yahka to support webcams + * ~~added ffmpeg-package for yahka to support webcams~~ * v1.1.2beta (2018-04-04) * added ENV for timezone issue * v1.1.1beta (2018-03-29) @@ -234,7 +234,7 @@ Thank you! * added some maintenance scripts ### v0.2.1 (2017-08-16) -* added libfontconfig package (for iobroker.phantomjs) +* ~~added libfontconfig package (for iobroker.phantomjs)~~ * added gnupg2 package as prerequisite for installing node version 6 ### v0.2.0 (2017-06-04) @@ -242,7 +242,7 @@ Thank you! * changed node version from 4 to 6 ### v0.1.2 (2017-03-14) -* added libpcap-dev package (for iobroker.amazon-dash) +* ~~added libpcap-dev package (for iobroker.amazon-dash)~~ ### v0.1.1 (2017-03-10) * added git package From ac6709982cab1d5dfc847323be3f86fa77b97792 Mon Sep 17 00:00:00 2001 From: Andre Date: Thu, 16 Apr 2020 11:38:13 +0200 Subject: [PATCH 3/8] Update README.md --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index eb21684..36b043a 100644 --- a/README.md +++ b/README.md @@ -211,7 +211,7 @@ Thank you! ### v1.2.0 (2018-08-21) * v1.1.3beta (2018-08-21) - * added ffmpeg-package for yahka to support webcams + * ~~added ffmpeg-package for yahka to support webcams~~ * v1.1.2beta (2018-04-04) * added ENV for timezone issue * v1.1.1beta (2018-03-29) @@ -234,7 +234,7 @@ Thank you! * added some maintenance scripts ### v0.2.1 (2017-08-16) -* added libfontconfig package (for iobroker.phantomjs) +* ~~added libfontconfig package (for iobroker.phantomjs)~~ * added gnupg2 package as prerequisite for installing node version 6 ### v0.2.0 (2017-06-04) @@ -242,7 +242,7 @@ Thank you! * changed node version from 4 to 6 ### v0.1.2 (2017-03-14) -* added libpcap-dev package (for iobroker.amazon-dash) +* ~~added libpcap-dev package (for iobroker.amazon-dash)~~ ### v0.1.1 (2017-03-10) * added git package From c3cd27fe34eeb4f12d074d643f1c29a38395b59e Mon Sep 17 00:00:00 2001 From: buanet Date: Mon, 4 May 2020 10:17:58 +0200 Subject: [PATCH 4/8] node 12 testing --- amd64/Dockerfile | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/amd64/Dockerfile b/amd64/Dockerfile index 9f15b1d..f0a3d33 100644 --- a/amd64/Dockerfile +++ b/amd64/Dockerfile @@ -30,8 +30,8 @@ RUN apt-get update && apt-get install -y \ wget \ && rm -rf /var/lib/apt/lists/* -# Install node10 -RUN curl -sL https://deb.nodesource.com/setup_10.x | bash \ +# Install node +RUN curl -sL https://deb.nodesource.com/setup_12.x | bash \ && apt-get update && apt-get install -y nodejs \ && rm -rf /var/lib/apt/lists/* From b35b6c17ad05ca40d86f78040b477ed454081af8 Mon Sep 17 00:00:00 2001 From: buanet Date: Mon, 4 May 2020 10:23:43 +0200 Subject: [PATCH 5/8] back to node 10 --- amd64/Dockerfile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/amd64/Dockerfile b/amd64/Dockerfile index f0a3d33..290fb8d 100644 --- a/amd64/Dockerfile +++ b/amd64/Dockerfile @@ -31,7 +31,7 @@ RUN apt-get update && apt-get install -y \ && rm -rf /var/lib/apt/lists/* # Install node -RUN curl -sL https://deb.nodesource.com/setup_12.x | bash \ +RUN curl -sL https://deb.nodesource.com/setup_10.x | bash \ && apt-get update && apt-get install -y nodejs \ && rm -rf /var/lib/apt/lists/* From 0b705506cfdb8f19a1f185a71e87a61153a939c5 Mon Sep 17 00:00:00 2001 From: Andre Date: Thu, 7 May 2020 23:55:48 +0200 Subject: [PATCH 6/8] Update README.md --- README.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 36b043a..c36c13b 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,13 @@ # ioBroker for Docker -[![Build Status](https://travis-ci.org/buanet/docker-iobroker.svg?branch=master)](https://travis-ci.org/buanet/docker-iobroker) - -Source: https://github.com/buanet/docker-iobroker +[![Release](https://img.shields.io/github/v/release/buanet/docker-iobroker)](https://github.com/buanet/docker-iobroker/releases) +[![Build Status](https://travis-ci.org/buanet/docker-iobroker.svg?branch=master)](https://travis-ci.org/buanet/docker-iobroker)
+[![Image Size](https://img.shields.io/docker/image-size/buanet/iobroker)](https://hub.docker.com/repository/docker/buanet/iobroker) +[![Docker Pulls](https://img.shields.io/docker/pulls/buanet/iobroker)](https://hub.docker.com/repository/docker/buanet/iobroker) +[![Docker Stars](https://img.shields.io/docker/stars/buanet/iobroker)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Source](https://img.shields.io/badge/source-github-blue)](https://github.com/buanet/docker-iobroker) +[![License](https://img.shields.io/github/license/buanet/docker-iobroker)](https://github.com/buanet/docker-iobroker/blob/master/LICENSE.md) +[![Donate](https://img.shields.io/badge/donate-paypal-blue)](https://paypal.me/buanet) IoBroker for Docker is an Dockerimage for ioBroker IoT platform (http://www.iobroker.net). From b7e9efaf40f96547dd513d97c7067c815bd4bae3 Mon Sep 17 00:00:00 2001 From: Andre Germann Date: Fri, 8 May 2020 23:54:42 +0200 Subject: [PATCH 7/8] Update README.md --- README.md | 35 ++++++++++++++++++++++++++--------- 1 file changed, 26 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index c36c13b..5f5148a 100644 --- a/README.md +++ b/README.md @@ -9,20 +9,19 @@ [![License](https://img.shields.io/github/license/buanet/docker-iobroker)](https://github.com/buanet/docker-iobroker/blob/master/LICENSE.md) [![Donate](https://img.shields.io/badge/donate-paypal-blue)](https://paypal.me/buanet) -IoBroker for Docker is an Dockerimage for ioBroker IoT platform (http://www.iobroker.net). +IoBroker for Docker is a Dockerimage for ioBroker IoT platform (http://www.iobroker.net). -It is originally made for and always tested on a Synology Disk Station 1515+ with DSM 6 and official Docker package installed. But it also works on other systems with Docker installed! +It was originally created for a Synology Disk Station 1515+ with DSM 6 and official Docker package installed. After more than three years of development it might be the best documented and still maintained Dockrimage for running ioBroker ioT platform with Docker. -Version 4 now supports running the Image in Docker on the following architectures: amd64, armv7hf, aarch64. -Feel free to ask for more architectures by opening an github issue. +Since v4.0.0 the image is available for the following architectures: amd64, armv7hf, aarch64. +If you need more please let me know by opening a Github issue. ## Important notice -The new v4 comes again with a new major node version (node10)! -If you are updating an existing installation you have to perform some additional steps inside ioBroker! -After upgrading your iobroker container you have to call "npm rebuild" or "reinstall.sh" (when js-controller > v1.5 "reinstall.js") for recompileing your installation for the use with node10! -For more details please see official ioBroker documentation: [EN](https://www.iobroker.net/#en/documentation/install/updatenode.md) | [DE](https://www.iobroker.net/#de/documentation/install/updatenode.md). -Make backup first! +Normally a new major version (e.g. v2, v4 and upcoming v5) of the image comes with a new, preinstalled major node version! +If you are updating an existing installation to a new major version (e.g. from v4 to v5) you have to perform some additional steps inside ioBroker! For more details please see official ioBroker documentation: [EN](https://www.iobroker.net/#en/documentation/install/updatenode.md) | [DE](https://www.iobroker.net/#de/documentation/install/updatenode.md).
+You might avoid these procedure if you use my "Best practise" hint for "upgrading your ioBroker container". +In any case make a backup first! ## Getting started @@ -117,6 +116,24 @@ Basically there are two different scripts which will be read and called by the s Hint: To get familiar with that feature try the following: Create a Container, mount an empty folder to /opt/userscripts, start your container. Two scripts will be restored into the empty folder. Rename the example scripts by simply removing "\_example". Restart your container and take a look at the Log. In "Step 4 of 5: Applying special settings" you will see the messages generated by the example userscripts. +## Best practices + +### Avoid using "latest" tag + +To avoid conflicts when upgrading your container or getting in trouble when accedentially upgrading your container to a new major version I prefer using the version tag like "V4.2.0" instead of "latest" for creating yor container. Just think about when I tell you it is not possible to download a new image version of a specific tag as long as a conrainer depends on it.
+By the way it also makes it more safe to keep your image up to date by using "watchtower" or something like that. + +### Upgrading you container + +If you want to upgrade your ioBroker container to a new major version (e.g. from v4 to v5) I would prefer to do that by creating a bockup in ioBroker (by "iobroker backup" or backitup adapter) and restoring it to a completely new container. All you need is time an the following steps: +* make a backup by Commandline ("iobroker backup") or backitup adapter +* stop the old container +* create a new and empty data folder or volume and place your backupfile in it +* create a new container as your old or as you need it and use the new data folder/ volume for the /opt/iobroke mountpoint +* follow the log output of the container and be patient + +After this the startupscript inside the container will automatically detect and restore your backup to a new ioBroker instance. When iobroker is started after the restore it will install your adapters to the new ioBroker instance by itself. This might take some time but will get you the best and cleanest results... + ## Miscellaneous ### Subscribe to updates From 12264ca810ca99ce06a370524adb6abd048e68fe Mon Sep 17 00:00:00 2001 From: Andre Germann Date: Fri, 8 May 2020 23:55:29 +0200 Subject: [PATCH 8/8] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5f5148a..550dd5d 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ IoBroker for Docker is a Dockerimage for ioBroker IoT platform (http://www.iobro It was originally created for a Synology Disk Station 1515+ with DSM 6 and official Docker package installed. After more than three years of development it might be the best documented and still maintained Dockrimage for running ioBroker ioT platform with Docker. -Since v4.0.0 the image is available for the following architectures: amd64, armv7hf, aarch64. +Since v4.0.0 the image is available for the following architectures: amd64, armv7hf, aarch64.
If you need more please let me know by opening a Github issue. ## Important notice