update docs

Merge Hotfix v9.1.2 into main

.VERSION

@@ -0,0 +1 @@
+v9.1.2

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,14 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Did you read the docs? / Hast du die Doku gelesen?
+    url: https://docs.buanet.de/iobroker-docker-image/docs/
+    about: Please make sure you read the docs before submitting any issues. / Bitte stelle sicher, dass du die Dokumentation gelesen hast bevor du einen Fehler meldest.
+  - name: Questions? / Fragen?
+    url: https://github.com/buanet/ioBroker.docker/discussions
+    about: Ask your questions here! / Stell deine Fragen hier!
+  - name: ioBroker Community Forum
+    url: https://forum.iobroker.net/
+    about: Need support? Check out our ioBroker Community Forum. / Du benötigst Unterstützung? Wirf einen Blick in unser ioBroker Community Forum.
+  - name: ioBroker Discord Channel
+    url: https://discord.gg/5jGWNKnpZ8
+    about: Need support? Check out our ioBroker Discord channel. / Du benötigst Unterstützung? Wirf einen Blick in unseren ioBroker Discord Channel.

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -0,0 +1,17 @@
+name: Feature Request / Verbesserungsvorschlag
+description: Request a new feature here. / Schlage eine Verbesserung vor.
+title: "[Feature Request]: "
+labels: "enhancement"
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to give us your feedback! / Vielen Dank, dass du die Zeit nimmst uns Feedback zu geben!  
+  - type: textarea
+    id: description
+    attributes:
+      label: Description / Beschreibung
+      description: Please describe your request. / Bitte beschreibe deine Anforderung.
+      placeholder: What are your ideas? / Was sind deine Ideen?
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/problem_report.yaml

@@ -0,0 +1,32 @@
+name: Problem Report / Fehlermeldung
+description: Report a problem here. / Melde Fehler hier. 
+title: "[Problem]: "
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report! / Vielen Dank, dass du dir die Zeit nimmst den Fehlerreport auszufüllen! 
+  - type: textarea
+    id: description
+    attributes:
+      label: Description / Beschreibung
+      description: Please describe your problem. / Bitte beschreibe dein Problem.
+      placeholder: What happened? What did you expect? / Was ist passiert? Was hast du erwartet? 
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Image version
+      description: Which image version do you use? / Welche Version des Images verwendest du? 
+      placeholder: v1.2.3
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Docker logs / Docker Protokoll
+      description: Please provide the full Docker log output from your Docker container startup. / Bitte stelle das komplette Docker Protokoll vom Start des Containers zur Verfügung.  
+      render: shell
+    validations:
+      required: true

.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    target-branch: "beta"

.github/dependencies/.admin-version

@@ -0,0 +1 @@
+6.13.16

.github/dependencies/.backitup-version

@@ -0,0 +1 @@
+2.10.11

.github/dependencies/.discovery-version

@@ -0,0 +1 @@
+4.4.0

.github/dependencies/.js-controller-version

@@ -0,0 +1 @@
+5.0.19

.github/dependencies/.nodejs-version

@@ -0,0 +1 @@
+v18.20.1

.github/workflows/build-debian12-beta.yml

@@ -0,0 +1,160 @@
+# Github action to build Debian12 image (Tag: beta)
+name: Build Debian 12 Image (beta)
+
+on:
+  release:
+    types: [prereleased]
+  workflow_dispatch:
+    inputs:
+      chose_node_version:
+        type: choice
+        description: 'Which Node version should be used?'
+        options:
+          - 'Recommended Node version (default)'
+          - 'Experimental Node version'
+          - 'Both Node versions'
+
+jobs:
+  build-with-recommended-node:
+    if: inputs.chose_node_version == 'Recommended Node version (default)' || inputs.chose_node_version == 'Both Node versions' || github.event_name == 'release'
+    name: Build with recommended Node version
+    runs-on: ubuntu-latest
+    steps:
+      - name: Fetch latest prerelease tag
+        run: echo "RELEASE_TAG=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
+
+      - name: Checkout repo
+        uses: actions/checkout@v4.1.2
+        with:
+          repository: 'buanet/ioBroker.docker'
+          ref: ${{ env.RELEASE_TAG }}
+
+      - name: Set job variables
+        run: |
+          VERSION="$(cat .VERSION)"
+          MAJORVERSION="$(cat .VERSION | cut -c 1-2 | sed -r 's#^(.{0})#\1latest-#')"
+          DATI="$(date --rfc-3339=seconds | sed 's/ /T/')"
+          # Log output and export as Github environment variable
+          echo "[LOG] Nodejs Version: ${{ vars.RECOMMENDED_NODE_VERSION }}"
+          echo "[LOG] Image Version: $VERSION"
+          echo "version=$VERSION" >> $GITHUB_ENV
+          echo "[LOG] Major Image Version: $MAJORVERSION"
+          echo "majorversion=$MAJORVERSION" >> $GITHUB_ENV
+          echo "[LOG] Buildnumber/Timestamp: $DATI"
+          echo "dati=$DATI" >> $GITHUB_ENV
+          # Set values in iobroker_startup.sh
+          sed -e "s/\${VERSION}/$VERSION/" -e "s/\${BUILD}/$DATI/" ./debian12/scripts/iobroker_startup.sh > ./debian12/scripts/iobroker_startup.tmp
+          mv -f ./debian12/scripts/iobroker_startup.tmp ./debian12/scripts/iobroker_startup.sh
+          # Set values in Dockerfile
+          sed -e "s/\${VERSION}/$VERSION/" -e "s/\${DATI}/$DATI/" -e "s/\${NODE}/${{ vars.RECOMMENDED_NODE_VERSION }}/" ./debian12/Dockerfile > ./debian12/Dockerfile.tmp 
+          mv -f ./debian12/Dockerfile.tmp ./debian12/Dockerfile
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3.0.0
+
+      - name: Set up Docker Buildx
+        id: buildx
+        uses: docker/setup-buildx-action@v3.2.0
+
+      - name: Login to DockerHub
+        uses: docker/login-action@v3.1.0
+        with:
+          username: ${{ secrets.DOCKER_USER }}
+          password: ${{ secrets.DOCKER_PASS }}
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3.1.0
+        with:
+          registry: ghcr.io
+          username: ${{ secrets.PACKAGES_USER }}
+          password: ${{ secrets.PACKAGES_PASS }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5.3.0
+        with:
+          context: ./debian12
+          file: ./debian12/Dockerfile
+          push: true
+          platforms: |
+            linux/amd64
+            linux/arm64/v8
+            linux/arm/v7
+          tags: |
+            buanet/iobroker:beta,
+            buanet/iobroker:${{ env.version }},
+            ghcr.io/buanet/iobroker:beta,
+            ghcr.io/buanet/iobroker:${{ env.version }}
+          provenance: false
+          outputs: type=image,name=target,annotation-index.org.opencontainers.image.description=Official Docker image for ioBroker smarthome software (https://www.iobroker.net)
+
+  build-with-experimental-node:
+    if: inputs.chose_node_version == 'Experimental Node version' || inputs.chose_node_version == 'Both Node versions' || github.event_name == 'release'
+    name: Build with experimental Node version
+    runs-on: ubuntu-latest
+    steps:
+        - name: Fetch latest prerelease tag
+          run: echo "RELEASE_TAG=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
+
+        - name: Checkout repo
+          uses: actions/checkout@v4.1.2
+          with:
+            repository: 'buanet/ioBroker.docker'
+            ref: ${{ env.RELEASE_TAG }}
+
+        - name: Set job variables
+          run: |
+            VERSION="$(cat .VERSION)"
+            MAJORVERSION="$(cat .VERSION | cut -c 1-2 | sed -r 's#^(.{0})#\1latest-#')"
+            DATI="$(date --rfc-3339=seconds | sed 's/ /T/')"
+            # Log output and export as Github environment variable
+            echo "[LOG] Nodejs Version: ${{ vars.EXPERIMENTAL_NODE_VERSION }}"
+            echo "[LOG] Image Version: $VERSION"
+            echo "version=$VERSION" >> $GITHUB_ENV
+            echo "[LOG] Major Image Version: $MAJORVERSION"
+            echo "majorversion=$MAJORVERSION" >> $GITHUB_ENV
+            echo "[LOG] Buildnumber/Timestamp: $DATI"
+            echo "dati=$DATI" >> $GITHUB_ENV
+            # Set values in iobroker_startup.sh
+            sed -e "s/\${VERSION}/$VERSION/" -e "s/\${BUILD}/$DATI/" ./debian12/scripts/iobroker_startup.sh > ./debian12/scripts/iobroker_startup.tmp
+            mv -f ./debian12/scripts/iobroker_startup.tmp ./debian12/scripts/iobroker_startup.sh
+            # Set values in Dockerfile
+            sed -e "s/\${VERSION}/$VERSION/" -e "s/\${DATI}/$DATI/" -e "s/\${NODE}/${{ vars.EXPERIMENTAL_NODE_VERSION }}/" ./debian12/Dockerfile > ./debian12/Dockerfile.tmp 
+            mv -f ./debian12/Dockerfile.tmp ./debian12/Dockerfile
+
+        - name: Set up QEMU
+          uses: docker/setup-qemu-action@v3.0.0
+
+        - name: Set up Docker Buildx
+          id: buildx
+          uses: docker/setup-buildx-action@v3.2.0
+
+        - name: Login to DockerHub
+          uses: docker/login-action@v3.1.0
+          with:
+            username: ${{ secrets.DOCKER_USER }}
+            password: ${{ secrets.DOCKER_PASS }}
+
+        - name: Login to GitHub Container Registry
+          uses: docker/login-action@v3.1.0
+          with:
+            registry: ghcr.io
+            username: ${{ secrets.PACKAGES_USER }}
+            password: ${{ secrets.PACKAGES_PASS }}
+
+        - name: Build and push Docker image
+          uses: docker/build-push-action@v5.3.0
+          with:
+            context: ./debian12
+            file: ./debian12/Dockerfile
+            push: true
+            platforms: |
+              linux/amd64
+              linux/arm64/v8
+              linux/arm/v7
+            tags: |
+              buanet/iobroker:beta-node${{ vars.EXPERIMENTAL_NODE_VERSION }},
+              buanet/iobroker:${{ env.version }}-node${{ vars.EXPERIMENTAL_NODE_VERSION }},
+              ghcr.io/buanet/iobroker:beta-node${{ vars.EXPERIMENTAL_NODE_VERSION }},
+              ghcr.io/buanet/iobroker:${{ env.version }}-node${{ vars.EXPERIMENTAL_NODE_VERSION }}
+            provenance: false
+            outputs: type=image,name=target,annotation-index.org.opencontainers.image.description=Official Docker image for ioBroker smarthome software (https://www.iobroker.net)

.github/workflows/build-debian12-dev.yml

@@ -0,0 +1,144 @@
+# Github action to build Debian12 image (Tag: dev)
+name: Build Debian 12 Image (dev)
+
+on:
+  workflow_dispatch:
+    inputs:
+      chose_node_version:
+        type: choice
+        description: 'Which Node version should be used?'
+        options:
+          - 'Recommended Node version (default)'
+          - 'Experimental Node version'
+          - 'Both Node versions'
+
+jobs:
+  build-with-recommended-node:
+    if: inputs.chose_node_version == 'Recommended Node version (default)' || inputs.chose_node_version == 'Both Node versions'
+    name: Build with recommended Node version
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4.1.2
+        with:
+          repository: 'buanet/ioBroker.docker'
+
+      - name: Set job variables
+        run: |
+          VERSION="$(cat .VERSION)"
+          MAJORVERSION="$(cat .VERSION | cut -c 1-2 | sed -r 's#^(.{0})#\1latest-#')"
+          DATI="$(date --rfc-3339=seconds | sed 's/ /T/')"
+          # Log output and export as Github environment variable
+          echo "[LOG] Nodejs Version: ${{ vars.RECOMMENDED_NODE_VERSION }}"
+          echo "[LOG] Image Version: $VERSION"
+          echo "version=$VERSION" >> $GITHUB_ENV
+          echo "[LOG] Major Image Version: $MAJORVERSION"
+          echo "majorversion=$MAJORVERSION" >> $GITHUB_ENV
+          echo "[LOG] Buildnumber/Timestamp: $DATI"
+          echo "dati=$DATI" >> $GITHUB_ENV
+          # Set values in iobroker_startup.sh
+          sed -e "s/\${VERSION}/$VERSION-dev/" -e "s/\${BUILD}/$DATI/" ./debian12/scripts/iobroker_startup.sh > ./debian12/scripts/iobroker_startup.tmp
+          mv -f ./debian12/scripts/iobroker_startup.tmp ./debian12/scripts/iobroker_startup.sh
+          # Set values in Dockerfile
+          sed -e "s/\${VERSION}/$VERSION-dev/" -e "s/\${DATI}/$DATI/" -e "s/\${NODE}/${{ vars.RECOMMENDED_NODE_VERSION }}/" ./debian12/Dockerfile > ./debian12/Dockerfile.tmp 
+          mv -f ./debian12/Dockerfile.tmp ./debian12/Dockerfile
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3.0.0
+
+      - name: Set up Docker Buildx
+        id: buildx
+        uses: docker/setup-buildx-action@v3.2.0
+
+      - name: Login to DockerHub
+        uses: docker/login-action@v3.1.0
+        with:
+          username: ${{ secrets.DOCKER_USER }}
+          password: ${{ secrets.DOCKER_PASS }}
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3.1.0
+        with:
+          registry: ghcr.io
+          username: ${{ secrets.PACKAGES_USER }}
+          password: ${{ secrets.PACKAGES_PASS }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5.3.0
+        with:
+          context: ./debian12
+          file: ./debian12/Dockerfile
+          push: true
+          platforms: |
+            linux/amd64
+            linux/arm64/v8
+            linux/arm/v7
+          tags: |
+            buanet/iobroker:dev,
+            buanet/iobroker:dev-node${{ vars.RECOMMENDED_NODE_VERSION }},
+            ghcr.io/buanet/iobroker:dev,
+            ghcr.io/buanet/iobroker:dev-node${{ vars.RECOMMENDED_NODE_VERSION }}
+
+  build-with-experimental-node:
+    if: inputs.chose_node_version == 'Experimental Node version' || inputs.chose_node_version == 'Both Node versions'
+    name: Build with experimental Node version
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4.1.2
+        with:
+          repository: 'buanet/ioBroker.docker'
+
+      - name: Set job variables
+        run: |
+          VERSION="$(cat .VERSION)"
+          MAJORVERSION="$(cat .VERSION | cut -c 1-2 | sed -r 's#^(.{0})#\1latest-#')"
+          DATI="$(date --rfc-3339=seconds | sed 's/ /T/')"
+          # Log output and export as Github environment variable
+          echo "[LOG] Nodejs Version: ${{ vars.EXPERIMENTAL_NODE_VERSION }}"
+          echo "[LOG] Image Version: $VERSION"
+          echo "version=$VERSION" >> $GITHUB_ENV
+          echo "[LOG] Major Image Version: $MAJORVERSION"
+          echo "majorversion=$MAJORVERSION" >> $GITHUB_ENV
+          echo "[LOG] Buildnumber/Timestamp: $DATI"
+          echo "dati=$DATI" >> $GITHUB_ENV
+          # Set values in iobroker_startup.sh
+          sed -e "s/\${VERSION}/$VERSION-dev/" -e "s/\${BUILD}/$DATI/" ./debian12/scripts/iobroker_startup.sh > ./debian12/scripts/iobroker_startup.tmp
+          mv -f ./debian12/scripts/iobroker_startup.tmp ./debian12/scripts/iobroker_startup.sh
+          # Set values in Dockerfile
+          sed -e "s/\${VERSION}/$VERSION-dev/" -e "s/\${DATI}/$DATI/" -e "s/\${NODE}/${{ vars.EXPERIMENTAL_NODE_VERSION }}/" ./debian12/Dockerfile > ./debian12/Dockerfile.tmp 
+          mv -f ./debian12/Dockerfile.tmp ./debian12/Dockerfile
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3.0.0
+
+      - name: Set up Docker Buildx
+        id: buildx
+        uses: docker/setup-buildx-action@v3.2.0
+
+      - name: Login to DockerHub
+        uses: docker/login-action@v3.1.0
+        with:
+          username: ${{ secrets.DOCKER_USER }}
+          password: ${{ secrets.DOCKER_PASS }}
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3.1.0
+        with:
+          registry: ghcr.io
+          username: ${{ secrets.PACKAGES_USER }}
+          password: ${{ secrets.PACKAGES_PASS }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5.3.0
+        with:
+          context: ./debian12
+          file: ./debian12/Dockerfile
+          push: true
+          platforms: |
+            linux/amd64
+            linux/arm64/v8
+            linux/arm/v7
+          tags: |
+            buanet/iobroker:dev-node${{ vars.EXPERIMENTAL_NODE_VERSION }},
+            ghcr.io/buanet/iobroker:dev-node${{ vars.EXPERIMENTAL_NODE_VERSION }}

.github/workflows/build-debian12-latest.yml

@@ -0,0 +1,150 @@
+# Github action to build Debian12 image (Tag: latest)
+name: Build Debian 12 Image (latest)
+
+on:
+  release:
+    types: [released]
+  workflow_dispatch:
+
+jobs:
+  build-latest-for-buanet:
+    name: Build latest image for buanet
+    runs-on: ubuntu-latest
+    steps:
+      - name: Fetch latest release tag
+        run: |
+          LATESTRELEASE="$(curl -sL https://api.github.com/repos/buanet/ioBroker.docker/releases/latest | jq -r '.tag_name')"
+          echo "Latest release tag : $LATESTRELEASE"
+          echo "RELEASE_TAG=$LATESTRELEASE" >> $GITHUB_ENV
+
+      - name: Checkout repo
+        uses: actions/checkout@v4.1.2
+        with:
+          repository: 'buanet/ioBroker.docker'
+          ref: ${{ env.RELEASE_TAG }}
+
+      - name: Set job variables
+        run: |
+          VERSION="$(cat .VERSION)"
+          MAJORVERSION="$(cat .VERSION | cut -c 1-2 | sed -r 's#^(.{0})#\1latest-#')"
+          DATI="$(date --rfc-3339=seconds | sed 's/ /T/')"
+          # Log output and export as Github environment variable
+          echo "[LOG] Nodejs Version: ${{ vars.RECOMMENDED_NODE_VERSION }}"
+          echo "[LOG] Image Version: $VERSION"
+          echo "version=$VERSION" >> $GITHUB_ENV
+          echo "[LOG] Major Image Version: $MAJORVERSION"
+          echo "majorversion=$MAJORVERSION" >> $GITHUB_ENV
+          echo "[LOG] Buildnumber/Timestamp: $DATI"
+          echo "dati=$DATI" >> $GITHUB_ENV
+          # Set values in iobroker_startup.sh
+          sed -e "s/\${VERSION}/$VERSION/" -e "s/\${BUILD}/$DATI/" ./debian12/scripts/iobroker_startup.sh > ./debian12/scripts/iobroker_startup.tmp
+          mv -f ./debian12/scripts/iobroker_startup.tmp ./debian12/scripts/iobroker_startup.sh
+          # Set values in Dockerfile
+          sed -e "s/\${VERSION}/$VERSION/" -e "s/\${DATI}/$DATI/" -e "s/\${NODE}/${{ vars.RECOMMENDED_NODE_VERSION }}/" ./debian12/Dockerfile > ./debian12/Dockerfile.tmp 
+          mv -f ./debian12/Dockerfile.tmp ./debian12/Dockerfile
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3.0.0
+
+      - name: Set up Docker Buildx
+        id: buildx
+        uses: docker/setup-buildx-action@v3.2.0
+
+      - name: Login to DockerHub (buanet)
+        uses: docker/login-action@v3.1.0
+        with:
+          username: ${{ secrets.DOCKER_USER }}
+          password: ${{ secrets.DOCKER_PASS }}
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3.1.0
+        with:
+          registry: ghcr.io
+          username: ${{ secrets.PACKAGES_USER }}
+          password: ${{ secrets.PACKAGES_PASS }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5.3.0
+        with:
+          context: ./debian12
+          file: ./debian12/Dockerfile
+          push: true
+          platforms: |
+            linux/amd64
+            linux/arm64/v8
+            linux/arm/v7
+          tags: |
+            buanet/iobroker:latest,
+            buanet/iobroker:${{ env.majorversion }},
+            buanet/iobroker:${{ env.version }},
+            ghcr.io/buanet/iobroker:latest,
+            ghcr.io/buanet/iobroker:${{ env.majorversion }},
+            ghcr.io/buanet/iobroker:${{ env.version }}
+          provenance: false
+          outputs: type=image,name=target,annotation-index.org.opencontainers.image.description=Official Docker image for ioBroker smarthome software (https://www.iobroker.net)
+
+  build-latest-for-iobroker:
+    name: Build latest image for iobroker
+    runs-on: ubuntu-latest
+    steps:
+      - name: Fetch latest release tag
+        run: |
+          LATESTRELEASE="$(curl -sL https://api.github.com/repos/buanet/ioBroker.docker/releases/latest | jq -r '.tag_name')"
+          echo "Latest release tag : $LATESTRELEASE"
+          echo "RELEASE_TAG=$LATESTRELEASE" >> $GITHUB_ENV
+
+      - name: Checkout repo
+        uses: actions/checkout@v4.1.2
+        with:
+          repository: 'buanet/ioBroker.docker'
+          ref: ${{ env.RELEASE_TAG }}
+
+      - name: Set job variables
+        run: |
+          VERSION="$(cat .VERSION)"
+          MAJORVERSION="$(cat .VERSION | cut -c 1-2 | sed -r 's#^(.{0})#\1latest-#')"
+          DATI="$(date --rfc-3339=seconds | sed 's/ /T/')"
+          # Log output and export as Github environment variable
+          echo "[LOG] Nodejs Version: ${{ vars.RECOMMENDED_NODE_VERSION }}"
+          echo "[LOG] Image Version: $VERSION"
+          echo "version=$VERSION" >> $GITHUB_ENV
+          echo "[LOG] Major Image Version: $MAJORVERSION"
+          echo "majorversion=$MAJORVERSION" >> $GITHUB_ENV
+          echo "[LOG] Buildnumber/Timestamp: $DATI"
+          echo "dati=$DATI" >> $GITHUB_ENV
+          # Set values in iobroker_startup.sh
+          sed -e "s/\${VERSION}/$VERSION/" -e "s/\${BUILD}/$DATI/" ./debian12/scripts/iobroker_startup.sh > ./debian12/scripts/iobroker_startup.tmp
+          mv -f ./debian12/scripts/iobroker_startup.tmp ./debian12/scripts/iobroker_startup.sh
+          # Set values in Dockerfile
+          sed -e "s/\${VERSION}/$VERSION/" -e "s/\${DATI}/$DATI/" -e "s/\${NODE}/${{ vars.RECOMMENDED_NODE_VERSION }}/" ./debian12/Dockerfile > ./debian12/Dockerfile.tmp 
+          mv -f ./debian12/Dockerfile.tmp ./debian12/Dockerfile
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3.0.0
+
+      - name: Set up Docker Buildx
+        id: buildx
+        uses: docker/setup-buildx-action@v3.2.0
+
+      - name: Login to DockerHub (buanet)
+        uses: docker/login-action@v3.1.0
+        with:
+          username: ${{ secrets.DOCKER_USER_IOB }}
+          password: ${{ secrets.DOCKER_PASS_IOB }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5.3.0
+        with:
+          context: ./debian12
+          file: ./debian12/Dockerfile
+          push: true
+          platforms: |
+            linux/amd64
+            linux/arm64/v8
+            linux/arm/v7
+          tags: |
+            iobroker/iobroker:latest,
+            iobroker/iobroker:${{ env.majorversion }},
+            iobroker/iobroker:${{ env.version }},
+          provenance: false
+          outputs: type=image,name=target,annotation-index.org.opencontainers.image.description=Official Docker image for ioBroker smarthome software (https://www.iobroker.net)

.github/workflows/testing-docker-image.yml

@@ -0,0 +1,33 @@
+# Github action for testing the Docker image
+name: Testing Docker image
+
+on:
+  workflow_dispatch:
+
+jobs:
+  test-docker-image:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Testing with docker run
+        run: |
+          echo "[LOG] Starting ioBroker Container..."
+          docker run -d -p 8081:8081 --name iobroker -v iobrokerdata:/opt/iobroker buanet/iobroker:latest
+          echo "[LOG] Done."
+          echo ' '
+          echo "[LOG] Waiting for Startup Script..."
+          sleep 30
+          echo "[LOG] Done."
+          echo ' '
+          echo "[LOG] Writing Logs..."
+          docker logs iobroker >& testrun.log
+          echo "[LOG] Done."
+          echo ' '
+          echo "[LOG] Checking Web UI..."
+          curl --insecure http://127.0.0.1:8081 2> /dev/null | grep '<title>Admin</title>' &> /dev/null || exit 1
+          echo "[LOG] Done."
+          echo ' '
+          echo "[LOG] Output testrun.log:"
+          cat testrun.log
+          echo ' '
+          echo "[LOG] Test sucesssful."
+          echo ' '

.github/workflows/update-docker-readme.yml

@@ -0,0 +1,33 @@
+name: Update Docker Hub Readme
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '.github/workflows/update-docker-readme.yml'
+  workflow_dispatch:
+
+jobs:
+  update-docker-readme:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4.1.2
+
+    - name: Update Docker Hub Readme (buanet)
+      uses: peter-evans/dockerhub-description@v4.0.0
+      with:
+        username: ${{ secrets.DOCKER_USER }}
+        password: ${{ secrets.DOCKER_PASS }}
+        repository: buanet/iobroker
+        short-description: Official Docker image for ioBroker based on Debian Bullseye slim 
+        readme-filepath: ./docs/README_docker_hub_buanet.md
+
+    - name: Update Docker Hub Readme (iobroker)
+      uses: peter-evans/dockerhub-description@v4.0.0
+      with:
+        username: ${{ secrets.DOCKER_USER_IOB }}
+        password: ${{ secrets.DOCKER_PASS_IOB }}
+        repository: iobroker/iobroker
+        short-description: Official Docker image for ioBroker based on Debian Bullseye slim
+        readme-filepath: ./docs/README_docker_hub_iobroker.md

.github/workflows/version-checks.yml

@@ -0,0 +1,68 @@
+name: Version Checks
+
+on:
+  schedule:
+    - cron: '42 23 * * *'
+  workflow_dispatch:
+
+jobs:
+  check-and-trigger:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4.1.2
+        with:
+          repository: 'buanet/ioBroker.docker'
+          token: ${{ secrets.ACTIONS_PAT }}
+
+      - name: Get and write version
+        id: version
+        run: |
+          LATESTRELEASE="$(curl -sL https://api.github.com/repos/buanet/ioBroker.docker/releases/latest | jq -r '.tag_name')"
+          echo "iobroker=iobroker/iobroker:$LATESTRELEASE" >> $GITHUB_ENV
+          echo "baseimage=library/debian:bookworm-slim" >> $GITHUB_ENV
+
+      - name: Docker Baseimage Checker
+        id: baseimage
+        uses: mkumatag/container-image-updater-action@v1.0.6
+        with:
+          base-image: '${{ env.baseimage }}'
+          image: '${{ env.iobroker }}'
+
+      - name: Fetch ioBroker and nodejs versions
+        run: |
+          curl -sL https://repo.iobroker.live/sources-dist.json | \
+          jq -r '."js-controller".version' > .github/dependencies/.js-controller-version
+          echo "[LOG] Fetched js-controller version is $(cat .github/dependencies/.js-controller-version)"
+          curl -sL https://repo.iobroker.live/sources-dist.json | \
+          jq -r '."admin".version' > .github/dependencies/.admin-version
+          echo "[LOG] Fetched admin version is $(cat .github/dependencies/.admin-version)"
+          curl -sL https://repo.iobroker.live/sources-dist.json | \
+          jq -r '."backitup".version' > .github/dependencies/.backitup-version
+          echo "[LOG] Fetched backitup version is $(cat .github/dependencies/.backitup-version)"
+          curl -sL https://repo.iobroker.live/sources-dist.json | \
+          jq -r '."discovery".version' > .github/dependencies/.discovery-version
+          echo "[LOG] Fetched discovery version is $(cat .github/dependencies/.discovery-version)"
+          curl -sL https://nodejs.org/dist/index.json | \
+          jq -r 'map(select(.version | startswith("v18."))) | .[0].version' > .github/dependencies/.nodejs-version
+          echo "[LOG] Fetched nodejs version is $(cat .github/dependencies/.nodejs-version)"
+
+      - name: Check for modified files
+        id: git-check
+        run: echo "modified=$([ -z "`git status --porcelain`" ] && echo "false" || echo "true")" >> $GITHUB_OUTPUT
+
+      - name: Commit latest release version
+        if: steps.git-check.outputs.modified == 'true'
+        run: |
+          git config --global user.name 'buanet'
+          git config --global user.email 'info@buanet.de'
+          git commit -am "new ioBroker versions"
+          git push
+
+      - name: Trigger Build Debian 12 Image (latest)
+        if: steps.baseimage.outputs.needs-update == 'true' || steps.git-check.outputs.modified == 'true'
+        uses: benc-uk/workflow-dispatch@v1.2
+        with:
+          workflow: Build Debian 12 Image (latest)
+          repo: buanet/ioBroker.docker
+          token: ${{ secrets.ACTIONS_PAT }}

.gitignore

@@ -0,0 +1 @@
+.vscode/

CHANGELOG.md

@@ -0,0 +1,343 @@
+## Changelog
+
+### v9.1.2 (05.04.2024)
+* fix build process by updating npm to latest
+
+### v9.1.1 (24.01.2024)
+* fix node js setup
+
+### v9.1.0 (19.01.2024)
+* update docs and ci
+* v9.1.0-beta.4 (08.01.2024)
+  * dropping arm/v7 support (temporary)
+  * add trap for debugging mode ([#421](https://github.com/buanet/ioBroker.docker/issues/421))
+  * fix ownership of userscripts ([#423 by @EugenMayer](https://github.com/buanet/ioBroker.docker/pull/423))
+  * add strict mode to healthcheck.sh ([#424 by @EugenMayer](https://github.com/buanet/ioBroker.docker/pull/424))
+  * fixes for ci process and dockerfile
+  * remove deprecated files from repo
+* v9.1.0-beta.3 (23.11.2023)
+  * add --force to restore in maintenance script
+  * improve shebang in scripts for downgrade and portability
+* v9.1.0-beta.2 (06.11.2023)
+  * enhance logging/ fix typos
+  * add env PACKAGES_UPDATE and remove automatic package updates on first container start
+  * improve setuid/setgid handling during startup ([#397](https://github.com/buanet/ioBroker.docker/issues/397))
+  * move maintenance script registration to dockerfile ([#390](https://github.com/buanet/ioBroker.docker/issues/390))
+* v9.1.0-beta.1 (03.11.2023)
+  * improve maintenance command by symlinking ([#390](https://github.com/buanet/ioBroker.docker/issues/390))
+  * fix restore/ adding backup file selection ([#394](https://github.com/buanet/ioBroker.docker/issues/394))
+  * fix calling iob start|stop with parameters
+  * enhance logging in iobroker_startup.sh
+  * add error handling for user scripts
+
+### v9.0.1 (10.10.2023)
+* fix issue with avahi setup ([#384](https://github.com/buanet/ioBroker.docker/issues/384); [#385 by @z1r0](https://github.com/buanet/ioBroker.docker/pull/385))
+* add silent cleanup to setup_avahi.sh
+* add error handling for package updates/ install
+* fix calling iob in iobroker_startup.sh ([#388](https://github.com/buanet/ioBroker.docker/issues/388))
+
+### v9.0.0 (09.10.2023)
+* update official docs
+* v9.0.0-beta.2 (28.09.2023)
+  * fix issue with unlocking features in backitup ([#381](https://github.com/buanet/ioBroker.docker/issues/381))
+  * fix issue with fresh initializing iobroker
+* v9.0.0-beta.1 (24.09.2023)
+  * remove special settings script and env for zwave ([#377](https://github.com/buanet/ioBroker.docker/issues/377))
+  * simplify ci/ reduce gh actions
+  * ignore errors in "silent cleanup" on first start ([#369](https://github.com/buanet/ioBroker.docker/issues/369))
+  * cleanup/ restructure repo
+  * update nodejs setup process
+  * update base image to debian 12 (bookworm)
+  * improve security by avoiding root (except startup script itself)
+  * restrict iobroker command line commands (start/ stop/ node fix)
+  * integrate maintenance script into iobroker command
+  * move container config files location
+
+### v8.1.0 (15.08.2023)
+* repo cleanup
+* v8.1.0-beta.4 (29.07.2023)
+  * fix container restart in maintenance script 
+  * fix running maintenance script as iobroker
+  * enhance quoting ([#357 by @dontobi](https://github.com/buanet/ioBroker.docker/pull/357))
+* v8.1.0-beta.3 (05.07.2023)
+  * fix permission issue for restart container as iobroker user
+  * fix issue with js-controller ui upgrade
+  * fix small issues in maintenance script
+  * update action workflows
+* v8.1.0-beta.2 (26.04.2023)
+  * prohibit restore when startup script is still running
+  * extend time before restart after restore is done
+  * influx data repo will be added automatically when PACKAGES contains influxdb or influxdb2-cli package
+* v8.1.0-beta.1 (14.04.2023)
+  * enhance github actions
+  * enhance log output of maintenance script on restore ([#333](https://github.com/buanet/ioBroker.docker/issues/333))
+  * allow iobroker admin to be disabled at startup ([#332](https://github.com/buanet/ioBroker.docker/issues/332))
+  * allow deletion of objects and states db password with value "none" ([#306](https://github.com/buanet/ioBroker.docker/issues/306))
+
+### v8.0.1 (17.04.2023)
+* fix calling of "iob setup first" on slaves ([#335](https://github.com/buanet/ioBroker.docker/issues/335)) 
+
+### v8.0.0 (20.03.2023)
+* update readme and docs
+* remove manifests
+* enhance dockerfile, reduce image size ([#323](https://github.com/buanet/ioBroker.docker/issues/323))
+* v8.0.0-beta.1 (20.02.2023)
+  * upgrade node version to recommended node18  
+  * rewrite of multihost setup handling
+  * rewrite of custom objects and states db setup handling
+  * enhance initial packages install/ update
+  * enhance logging and error handling
+  * add volume instruction to dockerfile
+  * add support for password protected custom objects and states db ([#306](https://github.com/buanet/ioBroker.docker/issues/306))
+  * add support for redis sentinel ([#311](https://github.com/buanet/ioBroker.docker/issues/311))
+  * add restore command to maintenance script
+  * add database connection check at startup 
+  * remove initial restore feature
+
+### v7.2.0 (12.12.2022)
+* update docs
+* v7.2.0-beta.1 (30.11.2022)
+  * fix restart option in maintenance script
+  * add error handling for usb devices
+  * add aliases to maintenance script
+  * add env PERMISSION_CHECK ([#251](https://github.com/buanet/ioBroker.docker/issues/251))
+  * add some more DEBUG messages to log
+  * add env IOB_BACKITUP_EXTDB to unlock external db backups in backitup adapter
+  * reorder dockerfile steps to fulfill ioBroker Docker check
+
+### v7.1.2 (08.11.2022)
+* fix hostname check ([#293](https://github.com/buanet/ioBroker.docker/issues/293))
+
+### v7.1.1 (01.11.2022)
+* fix setting gid of iobroker group ([#289](https://github.com/buanet/ioBroker.docker/issues/289))
+
+### v7.1.0 (31.10.2022)
+* fix [build action node issue](https://forum.iobroker.net/topic/59518/docker-image-7-0-1-auf-node-js-14/14?_=1667244004952) for iobroker/iobroker repo
+* v7.1.0-beta.1 (12.10.2022)
+  * add env DEBUG for extended debugging log
+  * enhance logging in iobroker-startup.sh
+  * enhance build process
+  * add restart option to maintenance script
+  * add strict mode for iobroker-startup.sh
+  * fix "unary operator expected" error
+
+### v7.0.1 (05.07.2022)
+* backitup restore patch
+
+### v7.0.0 (21.06.2022)
+* update docs & ci
+* v7.0.0-beta.1 (16.06.2022)
+  * upgrade node version to recommended node16 
+  * rewrite maintenance script ([#243 by @agross](https://github.com/buanet/ioBroker.docker/pull/243))
+  * enhance container shutdown on SIGTERM ([as requested with #264 by @buzz0r](https://github.com/buanet/ioBroker.docker/pull/264))
+  * enhance startup script logging
+  * enhance logging for avahi & zwave install scripts
+  * add new env for offline mode (fixes [#255](https://github.com/buanet/ioBroker.docker/issues/255))
+
+### v6.1.0 (2022-03-01)
+* v6.1.0-beta.2 (2022-02-11)
+  * fix -kbn option in maintenance script
+  * enhance shutdown/ prevent warnings on upgrade
+  * remove hostname check for multihost slave
+  * enhance startup script logging
+  * add breaks and enhance maintenance script (fixes [#233](https://github.com/buanet/ioBroker.docker/issues/233))
+* v6.1.0-beta.1 (2021-12-23)
+  * some more corrections in maintenance script ([#232 by @agross](https://github.com/buanet/ioBroker.docker/pull/232)) 
+  * add auto confirm parameter to upgrade function in maintenance script ([#229 by @thost96](https://github.com/buanet/ioBroker.docker/pull/229))
+  * add alias "m" for maintenance script
+
+### v6.0.0 (2021-12-09)
+* move docs/ restructuring readme
+* v6.0.0-beta1 (2021-10-07)
+  * upgrade node version to recommended node14 
+  * add beta-node16 tag for beta testing node16
+  * update documentation
+* v5.3.0-beta1 (2021-10-07)
+  * add check (installed) PACKAGES on startup (fixes [#201](https://github.com/buanet/ioBroker.docker/issues/201))
+  * add packages for discovery adapter
+  * add packages for backitup adapter
+  * reorganize Dockerfile
+
+### v5.2.0 (2021-09-30)
+* v5.2.0-beta4 (2021-09-10)
+  * adding iobroker user rights for "gosu"
+  * adding more labels in OCI standard format
+  * fixing work dir bug
+  * adding backitup compatibility 
+* v5.2.0-beta3 (2021-09-04)
+  * reducing layers in dockerfile
+  * making hostname check mandatory for startup
+  * enhance startup log
+* v5.2.0-beta2 (2021-08-28)
+  * redesign maintenance script
+  * switching amd64 base image to debian bullseye slim 
+  * optimizing log output
+  * adding labels in OCI standard format
+  * adding packages update on first start
+  * adding file for docker detection by ioBroker adapters
+  * adding best practice for states db migration in readme
+  * removing couchdb option for states db (no longer supported)
+* v5.2.0-beta1 (2021-05-04)
+  * added upgrade parameter to maintenance script
+  * added expose for default admin ui port (fixes [#172](https://github.com/buanet/ioBroker.docker/issues/172))
+  * added short form for maintenance script
+* v5.2.0-beta (2021-04-02)
+  * some renaming to enhance automated build
+  * changes in versioning
+  * delete travis for automated build
+
+### v5.1.0 (2020-11-05)
+* v5.0.2-beta (2020-07-28)
+  * added docker tag for major version latest
+  * extend readme.md docs
+  * added maintenance script
+  * added container health check
+  * fixed configuration procedure and logging for objects and states db setup
+* v5.0.1-beta (2020-07-01)
+  * fixing backup detection in startup script
+  * fixing permission issue on iobroker restored
+  * extended Logging
+  * enhance multihost support
+
+### v5.0.0 (2020-06-29)
+* v4.2.4-beta (2020-06-23)
+  * added graceful shutdown
+  * small fix for GID/UID handling
+  * adding new ENV "IOB_MULTIHOST" for multihost support
+  * small syntax fixes in iobroker_startup.sh
+* v4.2.3-beta (2020-06-05)
+  * ~~updating js-controller to not stable version 3.1.5 to fix renaming issue~~ (is stable now)
+* v4.2.2-beta (2020-06-03)
+  * ~~workaround for renaming issues on startup~~ (fixed in js-controller)
+* v4.2.1-beta (2020-05-10)
+  * using node 12 instead of 10
+  * updated documentation in readme.md
+
+### v4.2.0 (2020-04-14)
+* v4.1.4-beta (2020-04-07)
+  * switching base image to buster
+  * optimizing installation of packages defined by ENV "PACKAGES"
+* v4.1.3-beta (2020-02-08)
+  * renamed ENV for admin port (new "IOB_ADMINPORT)")
+  * added new ENVs for "iobroker setup custom" (replacing "REDIS")
+  * enhancements in startup script logging
+* v4.1.2-beta (2020-02-02)
+  * added feature for running user defined scripts on startup
+  * small fix for permissions issues on some systems
+* v4.1.1-beta (2020-01-17)
+  * updated openzwave to version 1.6.1007
+
+### v4.1.0 (2020-01-17)
+* improved readme.md
+* v4.0.3-beta (2020-01-06)
+  * added support to restore backup on startup ([#56 by @duffbeer2000](https://github.com/buanet/ioBroker.docker/pull/56))
+  * small fixes according to "docker best practices"
+* v4.0.2-beta (2019-12-10)
+  * ~~added env for activating redis~~
+  * enhancements in startup script and docker file
+* v4.0.1-beta (2019-11-25)
+  * added env for iobroker admin port
+  * added env for usb-devices (setting permissions)
+  * updating prerequisites for iobroker installation
+  * some small code fixes
+
+### v4.0.0 (2019-10-25)
+* v3.1.4-beta (2019-10-23)
+  * added env for zwave support
+* v3.1.3-beta (2019-10-17)
+  * enhanced logging of startup-script
+  * multi arch support (amd64, aarch64, armv7hf)
+* v3.1.2-beta (2019-09-03)
+  * using node 10 instead of node 8
+* v3.1.1-beta (2019-09-02)
+  * adding env for setting uid/ gid for iobroker-user ([#33 by @mplogas](https://github.com/buanet/ioBroker.docker/pull/33))
+
+### v3.1.0 (2019-08-21)
+* v3.0.3-beta (2019-08-21)
+  * switching base image from "debian:latest" to "debian:stretch"
+* v3.0.2-beta (2019-06-13)
+  * using gosu instead of sudo ([#26 by @SchumyHao](https://github.com/buanet/ioBroker.docker/pull/26))
+  * changing output of ioBroker logging
+* v3.0.1-beta (2019-05-18)
+  * ~~switching back to iobroker-daemon for startup~~
+
+### v3.0.0 (2019-05-09)
+* v2.0.6-beta (2019-04-14)
+  * added some additional logging
+  * fixing some issues for language env
+  * added permission fixing on first start
+* v2.0.5-beta (2019-02-09)
+  * added ENV to docker file
+  * added EXPOSE for admin
+  * final testing
+* v2.0.4-beta (2019-01-28)
+  * added support for env variables "avahi" and "packages"
+  * moving avahi-daemon installation into avahi startup script
+  * added script for installing optional packages
+  * optimizing logging output
+* v2.0.3-beta (2019-01-24)
+  * added support for running ioBroker under iobroker user
+  * optimizing logging output
+  * optimizing scripts
+* v2.0.2-beta (2019-01-23)
+  * optimizing and rearranged docker file
+  * changes for new ioBroker install script
+  * added restoring for empty mounted /opt/iobroker folder
+  * some more small fixes
+* v2.0.1-beta (2019-01-07)
+  * some changes for supporting other docker-environments than synology ds
+
+### v2.0.0 (2018-12-05)
+* v1.2.2-beta (2018-12-05)  
+  * using node8 instead of node6
+  * changes for new iobroker setup
+* v1.2.1-beta (2018-09-12)
+  * added support for firetv-adapter
+
+### v1.2.0 (2018-08-21)
+* v1.1.3-beta (2018-08-21)
+  * ~~added ffmpeg-package for yahka to support webcams~~
+* v1.1.2-beta (2018-04-04)
+  * added ENV for timezone issue
+* v1.1.1-beta (2018-03-29)
+  * added wget package
+  * updated readme.md
+
+###  v1.1.0 (2017-12-10)
+* v1.0.2-beta (2017-12-10)
+  * changed startup call to fix restart issue
+  * fixed avahi startup issue
+  * fixed hostname issue
+  * added z-wave support
+  * added logging to /opt/scripts/docker_iobroker_log.txt
+* v1.0.1-beta (2017-08-25)
+  * fixed locales issue
+
+### v1.0.0 (2017-08-22)
+* moved and renamed iobroker startup script
+* disabled iobroker daemon to (hopefully) fix restart issue
+* added some maintenance scripts
+
+### v0.2.1 (2017-08-16)
+* ~~added libfontconfig package (for iobroker.phantomjs)~~
+* added gnupg2 package as prerequisite for installing node version 6
+
+### v0.2.0 (2017-06-04)
+* fixed startup issue in startup.sh
+* changed node version from 4 to 6
+
+### v0.1.2 (2017-03-14)
+* ~~added libpcap-dev package (for iobroker.amazon-dash)~~
+
+### v0.1.1 (2017-03-10)
+* added git package
+
+### v0.1.0 (2017-03-08)
+* moved avahi-start.sh to separate directory
+* fixed timezone issue (sets now timezone to Europe/Berlin)
+
+### v0.0.2 (2017-03-06)
+* added support for avahi-daemon (installation and autostart)
+
+### v0.0.1 (2017-01-31)
+* project started / initial release

Dockerfile

@@ -1,22 +0,0 @@
-FROM debian:latest
-
-MAINTAINER Andre Germann <info@buanet.de>
-
-ENV DEBIAN_FRONTEND noninteractive
-
-RUN apt-get update && apt-get install -y apt-utils curl
-RUN curl -sL https://deb.nodesource.com/setup_4.x | bash
-RUN apt-get install -y build-essential python nodejs
-
-RUN mkdir -p /opt/iobroker/ && chmod 777 /opt/iobroker/
-
-WORKDIR /opt/iobroker/
-
-RUN npm install iobroker --unsafe-perm && echo $(hostname) > .install_host
-
-ADD scripts/startup.sh startup.sh
-RUN chmod +x startup.sh
-
-CMD /opt/iobroker/startup.sh
-
-ENV DEBIAN_FRONTEND teletype

LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017-2023 André Germann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,2 +1,103 @@
-# docker-iobroker
-Docker Image for ioBroker based on Debian
+# Official Docker Image for ioBroker
+
+ <img src="https://github.com/buanet/ioBroker.docker/raw/main/docs/img/iobroker_logo.png" width="600" title="ioBroker Logo">
+
+[![Release](https://img.shields.io/github/v/release/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/releases)
+[![Pre-Release)](https://img.shields.io/github/v/tag/buanet/ioBroker.docker?include_prereleases&label=pre-release)](https://github.com/buanet/ioBroker.docker/releases)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/buanet/ioBroker.docker/build-debian12-latest.yml?branch=main)](https://github.com/buanet/ioBroker.docker/actions/workflows/build-debian12-latest.yml)
+[![Github Issues](https://img.shields.io/github/issues/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/issues)
+[![Github Pull Requests](https://img.shields.io/github/issues-pr/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/pulls)
+[![GitHub Discussions](https://img.shields.io/github/discussions/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/discussions)<br>
+[![Arch](https://img.shields.io/badge/arch-amd64%20%7C%20arm32v7%20%7C%20arm64v8-blue)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Image Size (tag)](https://img.shields.io/docker/image-size/buanet/iobroker/latest?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Pulls](https://img.shields.io/docker/pulls/buanet/iobroker?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Stars](https://img.shields.io/docker/stars/buanet/iobroker?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)<br>
+[![Source](https://img.shields.io/badge/source-github-blue?style=flat)](https://github.com/buanet/ioBroker.docker)
+[![GitHub forks](https://img.shields.io/github/forks/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/network)
+[![GitHub stars](https://img.shields.io/github/stars/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/stargazers)
+[![License](https://img.shields.io/github/license/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/blob/master/LICENSE.md)
+[![Donate](https://img.shields.io/badge/donate-paypal-blue?style=flat)](https://paypal.me/buanet)
+
+The code provided in this repo is used to automatically generate the official Docker Image for ioBroker.
+
+Because this README has become more and more confusing, I decided to convert it into a full documentation and moved it to a ["better place"](https://docs.buanet.de/iobroker-docker-image/docs/).  
+
+## :rocket: Quick links 
+
+Don't know what's ioBroker? :arrow_right: [iobroker.net](https://www.iobroker.net)<br>
+Don't know what's Docker? :arrow_right: [docker.com](https://docker.com)<br>
+Looking for documentation? :arrow_right: [docs.buanet.de](https://docs.buanet.de/iobroker-docker-image/docs/)
+
+## :question: FAQ (frequently asked questions)
+
+### How to run the image? 
+
+You can find some basic information about the image amd how to run it on the [Docker Hub page](https://hub.docker.com/r/buanet/iobroker) or [here](https://github.com/buanet/ioBroker.docker/blob/main/docs/README_docker_hub_buanet.md).
+
+### Is there a more detailed documentation?
+
+You can find a detailed documentation of the image at [docs.buanet.de](https://docs.buanet.de/iobroker-docker-image/docs/). 
+
+### Where can I pull the image?
+
+You can pull the Docker image from:
+* [Docker Hub (buanet)](https://hub.docker.com/r/buanet/iobroker)
+* [Docker Hub (iobroker)](https://hub.docker.com/r/iobroker/iobroker)
+* [GitHub Container Repo](https://github.com/buanet/ioBroker.docker/pkgs/container/iobroker)
+
+### Where can I get help?
+
+If you have any questions or need help take a look at the [Discussions](https://github.com/buanet/ioBroker.docker/discussions) or join the ioBroker community:
+* [ioBroker forum](https://forum.iobroker.net/)
+* [Discord channel](https://discord.gg/5jGWNKnpZ8)
+* [Facebook group](https://www.facebook.com/groups/440499112958264/)
+
+### How to report an issue or request a feature?
+
+If you think you found an issue let us know by opening a [GitHub Issue](https://github.com/buanet/ioBroker.docker/issues). 
+Please do not use the issues for support questions. Not every error message is worth a new report. Use [Discussions](https://github.com/buanet/ioBroker.docker/discussions) if you are not sure.
+
+## :eyes: Miscellaneous
+
+### Beta testing
+
+If you want to get the newest features and changes feel free to use/ test the beta version of the Docker image. For more details and beta support join us at "beta testing & feedback" > "docker-image" at the [ioBroker Discord channel](https://discord.gg/5jGWNKnpZ8).
+
+### Support the project
+
+The easiest way to support this project is to leave me some likes/ stars on Github and Docker hub!<br>
+If you want to give something back to the community, feel free to take a look into the [open issues](https://github.com/buanet/ioBroker.docker/issues) or the [ioBroker forum thread](http://forum.iobroker.net/viewtopic.php?f=17&t=5089) and help me answering questions, fixing bugs or adding new features!<br>
+If that doesn't work for you and you want to buy me a pizza instead, you can do this here: <a href="https://www.paypal.me/buanet" target="_blank"><img src="https://github.com/buanet/ioBroker.docker/raw/main/docs/img/pp_logo.png" height="15" width="15"></a><br>
+Thank you!
+
+## :memo: Changelog
+
+Moved to [CHANGELOG.md](CHANGELOG.md).
+
+## :copyright: License
+
+MIT License
+
+Copyright (c) 2017-2023 André Germann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## :star: Credits
+
+Inspired by https://github.com/MehrCurry/docker-iobroker

debian12/Dockerfile

@@ -0,0 +1,117 @@
+FROM debian:bookworm-slim
+
+LABEL org.opencontainers.image.title="Official ioBroker Docker Image" \
+      org.opencontainers.image.description="Official Docker image for ioBroker smarthome software (https://www.iobroker.net)" \
+      org.opencontainers.image.documentation="https://github.com/buanet/ioBroker.docker#readme" \
+      org.opencontainers.image.authors="André Germann <info@buanet.de>" \
+      org.opencontainers.image.url="https://github.com/buanet/ioBroker.docker" \
+      org.opencontainers.image.source="https://github.com/buanet/ioBroker.docker" \
+      org.opencontainers.image.base.name="debian:bookworm-slim" \
+      org.opencontainers.image.version="${VERSION}" \
+      org.opencontainers.image.created="${DATI}"
+
+ENV DEBIAN_FRONTEND noninteractive
+
+# Copy files
+COPY scripts /opt/scripts
+COPY userscripts /opt/userscripts
+
+# Set up ioBroker
+RUN apt-get update && apt-get upgrade -y \
+    # Install prerequisites
+    && apt-get install -q -y --no-install-recommends \
+    apt-utils \
+    ca-certificates \
+    cifs-utils \
+    curl \
+    gnupg \
+    gosu \
+    iputils-ping \
+    jq \
+    libatomic1 \
+    locales \
+    nfs-common \
+    procps \
+    python3 \
+    python3-dev \
+    tar \
+    tzdata \
+    udev \
+    wget \
+    # Install node
+    && mkdir -p /etc/apt/keyrings \
+    && curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg \
+    && echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_${NODE}.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list \
+    && printf "Package: *\nPin: origin deb.nodesource.com\nPin-Priority: 1001\n" > /etc/apt/preferences.d/nodesource \
+    && apt-get update && apt-get install -q -y --no-install-recommends nodejs \
+    # Temp Fix (check/log npm version, update npm to latest)
+    && npm -v \
+    && npm install -g npm@latest \
+    && npm -v \
+    # Install node-gyp
+    && npm install --production -g node-gyp \
+    # Generating locales
+    && sed -i 's/^# *\(de_DE.UTF-8\)/\1/' /etc/locale.gen \
+    && sed -i 's/^# *\(en_US.UTF-8\)/\1/' /etc/locale.gen \
+    && locale-gen \
+    # Prepare .docker_config
+    && mkdir /opt/.docker_config \
+    && echo "starting" > /opt/.docker_config/.healthcheck \
+    && echo "${VERSION}" > /opt/.docker_config/.thisisdocker \
+    && echo "true" > /opt/.docker_config/.first_run \
+    # Prepare old .docker_config (needed until changed in iobroker)
+    && mkdir /opt/scripts/.docker_config \
+    && echo "${VERSION}" > /opt/scripts/.docker_config/.thisisdocker \
+    # Run iobroker installer
+    && curl -sL https://iobroker.net/install.sh | bash - \
+    # Deleting UUID from build
+    && iobroker unsetup -y \
+    && echo "true" > /opt/iobroker/.fresh_install \
+    # Backup initial ioBroker and userscript folder
+    && tar -cf /opt/initial_iobroker.tar /opt/iobroker \
+    && tar -cf /opt/initial_userscripts.tar /opt/userscripts \
+    # Setting up iobroker-user
+    && chsh -s /bin/bash iobroker \
+    && usermod --home /opt/iobroker iobroker \
+    && usermod -u 1000 iobroker \
+    && groupmod -g 1000 iobroker \
+    && chown root:iobroker /usr/sbin/gosu \
+    # Set permissions and ownership
+    && chown -R iobroker:iobroker /opt/scripts /opt/userscripts \
+    && chmod 755 /opt/scripts/*.sh \
+    && chmod 755 /opt/userscripts/*.sh \
+    # register maintenance command
+    && ln -s /opt/scripts/maintenance.sh /bin/maintenance \
+    && ln -s /opt/scripts/maintenance.sh /bin/maint \
+    && ln -s /opt/scripts/maintenance.sh /bin/m \
+    # Clean up installation cache
+    && apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false \
+    && apt-get autoclean -y \
+    && apt-get autoremove \
+    && apt-get clean \
+    && rm -rf /tmp/* /var/tmp/* /root/.cache/* /root/.npm/* /var/lib/apt/lists/*
+
+# Default environment variables
+ENV DEBIAN_FRONTEND="teletype" \
+    LANG="de_DE.UTF-8" \
+    LANGUAGE="de_DE:de" \
+    LC_ALL="de_DE.UTF-8" \
+    SETGID=1000 \
+    SETUID=1000 \
+    TZ="Europe/Berlin"
+
+# Default admin ui port
+EXPOSE 8081
+
+# Change work dir
+WORKDIR /opt/iobroker/
+
+# Healthcheck
+HEALTHCHECK --interval=15s --timeout=5s --retries=5 \
+    CMD ["/bin/bash", "-c", "/opt/scripts/healthcheck.sh"]
+
+# Volume for persistent data
+VOLUME ["/opt/iobroker"]
+
+# Run startup-script
+ENTRYPOINT ["/bin/bash", "-c", "/opt/scripts/iobroker_startup.sh"]

debian12/scripts/healthcheck.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+
+# bash strict mode
+set -euo pipefail
+
+# Script checks health of running container
+
+# bash strict mode
+set -e
+
+if [ "$(cat /opt/.docker_config/.healthcheck)" == "starting" ]
+then
+  echo "Health status: OK - Startup script is still running."
+  exit 0
+elif [ "$(cat /opt/.docker_config/.healthcheck)" == "maintenance" ]
+then
+  echo "Health status: OK - Container is running in maintenance mode."
+  exit 0
+elif [ "$(ps -fe|grep "[i]obroker.js-controller"|awk '{print $2}')" != "" ]
+then
+  echo "Health status: OK - Main process (js-controller) is running."
+  exit 0
+fi
+
+echo "Health status: !!! NOT OK !!! - Something went wrong. Please see container logs for more details and/or try restarting the container."
+exit 1

debian12/scripts/iobroker.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+
+# run iob fix
+iob_fix () {
+  if [ "$(id -u)" -eq 0 ]; then
+    echo "The ioBroker fixer script is not specifically designed to run in Docker."
+    echo "Although it is generally safe to use, use it at your own risk and make sure to restart your container immediately after execution!"
+
+    local reply
+    read -rp 'Do you want to continue? [yes/no] ' reply
+    if [[ "$reply" == y || "$reply" == Y || "$reply" == yes ]]; then
+      : # continue
+    else
+      return 1
+    fi
+    curl -sL https://iobroker.net/fix.sh | bash -
+  else
+    echo "Due to some limitations in Docker, you need to run the ioBroker fixer script as root."
+    echo "Please connect as root user and try again."
+  fi
+}
+
+# run iob diag
+iob_diag () {
+  if [ "$(id -u)" -eq 0 ]; then
+    echo "The ioBroker diag script is not specifically designed to run in Docker."
+    echo "Although it is generally safe to use, use it at your own risk."
+    local reply
+    read -rp 'Do you want to continue? [yes/no] ' reply
+    if [[ "$reply" == y || "$reply" == Y || "$reply" == yes ]]; then
+      : # continue
+    else
+      return 1
+    fi
+    curl -sLf https://iobroker.net/diag.sh --output /home/iobroker/.diag.sh && bash /home/iobroker/.diag.sh | gosu iobroker tee /home/iobroker/iob_diag.log
+  else
+    echo "Due to some limitations in Docker, you need to run the ioBroker fixer script as root."
+    echo "Please connect as root user and try again."
+  fi
+}
+
+# run iobroker maintenance script
+iob_maint() {
+  shift
+  if [ "$(id -u)" -eq 0 ]; then
+    gosu iobroker bash /opt/scripts/maintenance.sh "$@"
+  else
+    bash /opt/scripts/maintenance.sh "$@"
+  fi
+}
+
+# pass parameters and run iobroker.js
+iob_run() {
+  if [ "$(id -u)" -eq 0 ]; then
+    gosu iobroker node /opt/iobroker/node_modules/iobroker.js-controller/iobroker.js "$@"
+  else
+    node /opt/iobroker/node_modules/iobroker.js-controller/iobroker.js "$@"
+  fi
+}
+
+if [ "$1" = "fix" ]; then
+  # call iobroker fixer
+  iob_fix
+elif [ "$1" = "node fix" ]; then
+  # call iobroker node fixer
+  echo "The execution of this command is blocked as your ioBroker is running inside a Docker container!"
+  echo "To fix any issues with nodejs, please pull the latest version of the Docker image and recreate your container."
+elif [ "$1" = "diag" ]; then
+  # call iobroker diag script
+  iob_diag
+elif [ "$1" = "start" ] || [ "$1" = "stop" ] || [ "$1" = "restart" ]; then
+  # block execution of iobroker start | stop | restart but pass start | stop for adapters
+  if [ ! "$2" ]; then
+    echo "The execution of this command is blocked as your ioBroker is running inside a Docker container!"
+    echo "For more details see ioBroker Docker image docs (https://docs.buanet.de/iobroker-docker-image/docs/) or use the maintenance script 'maintenance --help'."
+  else
+    # passing all other parameters to iobroker.js but check for execution as root
+    iob_run "$@"
+  fi
+elif [ "$1" = "m" ] || [ "$1" = "maint" ] || [ "$1" = "maintenance" ]; then
+  # call iobroker maintenance script but check for execution as root
+  iob_maint "$@"
+else
+  # passing all other parameters to iobroker.js but check for execution as root
+  iob_run "$@"
+fi

debian12/scripts/iobroker_startup.sh

@@ -0,0 +1,596 @@
+#!/usr/bin/env bash
+
+# bash strict mode
+set -euo pipefail
+
+# Setting healthcheck status to "starting"
+echo "starting" > /opt/.docker_config/.healthcheck
+
+# Reading ENV
+set +u
+adminport=$IOB_ADMINPORT
+avahi=$AVAHI
+backitup=$IOB_BACKITUP_EXTDB
+debug=$DEBUG
+multihost=$IOB_MULTIHOST
+offlinemode=$OFFLINE_MODE
+objectsdbhost=$IOB_OBJECTSDB_HOST
+objectsdbport=$IOB_OBJECTSDB_PORT
+objectsdbtype=$IOB_OBJECTSDB_TYPE
+objectsdbname=$IOB_OBJECTSDB_NAME
+objectsdbpass=$IOB_OBJECTSDB_PASS
+packages=$PACKAGES
+packagesupdate=$PACKAGES_UPDATE
+permissioncheck=$PERMISSION_CHECK
+setgid=$SETGID
+setuid=$SETUID
+statesdbhost=$IOB_STATESDB_HOST
+statesdbport=$IOB_STATESDB_PORT
+statesdbtype=$IOB_STATESDB_TYPE
+statesdbname=$IOB_STATESDB_NAME
+statesdbpass=$IOB_STATESDB_PASS
+usbdevices=$USBDEVICES
+set -u
+
+pkill_timeout=10      # timeout for iobroker shutdown in seconds
+
+# Exit with error function 
+exit_with_error() {
+  echo " "
+  echo "This Script will exit now."
+  exit 1
+}
+
+# Stop on error function
+stop_on_error() {
+  if [[ "$debug" == "true" || "$debug" == "42" ]]; then 
+    echo " "
+    echo "[DEBUG] Debug mode prevents the container from exiting on errors."
+    echo "[DEBUG] This enables you to investigate or fix your issue on the command line."
+    echo "[DEBUG] If you want to stop or restart your container you have to do it manually."
+    echo "[DEBUG] IoBroker is not running!"
+    trap 'exit_with_error' SIGTERM SIGKILL
+    tail -f /dev/null & wait
+  else
+    exit_with_error
+  fi
+}
+
+# Getting date and time for logging
+dati=$(date '+%Y-%m-%d %H:%M:%S')
+
+# Logging header
+echo " "
+echo "$(printf -- '-%.0s' {1..80})"
+echo -n "$(printf -- '-%.0s' {1..25})" && echo -n "     ""$dati""      " && echo "$(printf -- '-%.0s' {1..25})"
+echo "$(printf -- '-%.0s' {1..80})"
+echo "-----                                                                      -----"
+echo "----- ██╗  ██████╗  ██████╗  ██████╗   ██████╗  ██╗  ██╗ ███████╗ ██████╗  -----"
+echo "----- ██║ ██╔═══██╗ ██╔══██╗ ██╔══██╗ ██╔═══██╗ ██║ ██╔╝ ██╔════╝ ██╔══██╗ -----"
+echo "----- ██║ ██║   ██║ ██████╔╝ ██████╔╝ ██║   ██║ █████╔╝  █████╗   ██████╔╝ -----"
+echo "----- ██║ ██║   ██║ ██╔══██╗ ██╔══██╗ ██║   ██║ ██╔═██╗  ██╔══╝   ██╔══██╗ -----"
+echo "----- ██║ ╚██████╔╝ ██████╔╝ ██║  ██║ ╚██████╔╝ ██║  ██╗ ███████╗ ██║  ██║ -----"
+echo "----- ╚═╝  ╚═════╝  ╚═════╝  ╚═╝  ╚═╝  ╚═════╝  ╚═╝  ╚═╝ ╚══════╝ ╚═╝  ╚═╝ -----"
+echo "-----                                                                      -----"
+echo "-----              Welcome to your ioBroker Docker container!              -----"
+echo "-----                    Startupscript is now running!                     -----"
+echo "-----                          Please be patient!                          -----"
+echo "$(printf -- '-%.0s' {1..80})"
+echo " "
+echo "$(printf -- '-%.0s' {1..80})"
+echo "-----                          System Information                          -----"
+echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" arch: "$(uname -m)")" && echo " -----"
+echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" hostname: "$(hostname)")" && echo " -----"
+echo "-----                                                                      -----"
+echo "-----                          Version Information                         -----"
+echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" image: "${VERSION}")" && echo " -----"
+echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" build: "${BUILD}")" && echo " -----"
+echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" node: "$(node -v)")" && echo " -----"
+echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" npm: "$(npm -v)")" && echo " -----"
+echo "-----                                                                      -----"
+echo "-----                        Environment Variables                         -----"
+if [[ "$adminport" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_ADMINPORT: "$adminport")" && echo " -----"; fi
+if [[ "$avahi" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" AVAHI: "$avahi")" && echo " -----"; fi
+if [[ "$debug" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" DEBUG: "$debug")" && echo " -----"; fi
+if [[ "$backitup" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_BACKITUP_EXTDB: "$backitup")" && echo " -----"; fi
+if [[ "$multihost" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_MULTIHOST: "$multihost")" && echo " -----"; fi
+if [[ "$objectsdbtype" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_OBJECTSDB_TYPE: "$objectsdbtype")" && echo " -----"; fi
+if [[ "$objectsdbhost" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_OBJECTSDB_HOST: "$objectsdbhost")" && echo " -----"; fi
+if [[ "$objectsdbport" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_OBJECTSDB_PORT: "$objectsdbport")" && echo " -----"; fi
+if [[ "$objectsdbname" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_OBJECTSDB_NAME: "$objectsdbname")" && echo " -----"; fi
+if [[ "$objectsdbpass" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_OBJECTSDB_PASS: "***")" && echo " -----"; fi
+if [[ "$statesdbtype" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_STATESDB_TYPE: "$statesdbtype")" && echo " -----"; fi
+if [[ "$statesdbhost" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_STATESDB_HOST: "$statesdbhost")" && echo " -----"; fi
+if [[ "$statesdbport" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_STATESDB_PORT: "$statesdbport")" && echo " -----"; fi
+if [[ "$statesdbname" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_STATESDB_NAME: "$statesdbname")" && echo " -----"; fi
+if [[ "$statesdbpass" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" IOB_STATESDB_PASS: "***")" && echo " -----"; fi
+if [[ "$offlinemode" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" OFFLINE_MODE: "$offlinemode")" && echo " -----"; fi
+if [[ "$packages" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" PACKAGES: "$packages")" && echo " -----"; fi
+if [[ "$packagesupdate" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" PACKAGES_UPDATE: "$packagesupdate")" && echo " -----"; fi
+if [[ "$permissioncheck" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" PERMISSION_CHECK: "$permissioncheck")" && echo " -----"; fi
+if [[ "$setgid" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" SETGID: "$setgid")" && echo " -----"; fi
+if [[ "$setuid" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" SETUID: "$setuid")" && echo " -----"; fi
+if [[ "$usbdevices" != "" ]]; then echo -n "-----                    " && echo -n "$(printf "%-20s %-28s" USBDEVICES: "$usbdevices")" && echo " -----"; fi
+echo "$(printf -- '-%.0s' {1..80})"
+echo " "
+
+# Debug logging notice
+if [[ "$debug" == "42" ]]; then
+  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+  echo "!!!!                              DON'T PANIC!                              !!!!"
+  echo "!!!!     Just grab your towel. Environment variable DEBUG is set to 42.     !!!!"
+  echo "!!!! What looks like the answer to everything is just a undocumented value. !!!!"
+  echo "!!!! Startup script will do nothing, except keeping your container running. !!!!"
+  echo "!!!!     This might be useful for investigating errors during startup.      !!!!"
+  echo "!!!!  If you did this by mistake, just remove environment variable DEBUG.   !!!!"
+  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+  stop_on_error
+elif [[ "$debug" == "true" ]]; then
+  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+  echo "!!!!                            DEBUG LOG ACTIVE                            !!!!"
+  echo "!!!!               Environment variable DEBUG is set to true.               !!!!"
+  echo "!!!! This will extend the logging output and may slow down container start. !!!!"
+  echo "!!!!          Please make sure to deactivate if no longer needed.           !!!!"
+  echo "!!!!     For more information see ioBroker Docker image documentation:      !!!!"
+  echo "!!!!           https://docs.buanet.de/iobroker-docker-image/docs/           !!!!"
+  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+  echo " "
+fi
+
+
+#####
+# STEP 1 - Preparing container
+#####
+echo "$(printf -- '-%.0s' {1..80})"
+echo "-----                   Step 1 of 5: Preparing Container                   -----"
+echo "$(printf -- '-%.0s' {1..80})"
+echo " "
+
+# Actions running on first start only
+if [[ -f /opt/.docker_config/.first_run ]]; then
+  # Updating Linux packages
+  if [[ "$offlinemode" = "true" ]]; then
+    echo "OFFLINE_MODE is \"true\". Skipping Linux package updates on first run."
+    echo " "
+  elif [[ "$packagesupdate" = "true" ]]; then
+    if ! bash /opt/scripts/setup_packages.sh -update; then echo "Failed."; fi
+    echo " "
+  fi
+
+  # Installing packages from ENV
+  if [[ "$packages" != "" && "$offlinemode" = "true" ]]; then
+    echo "PACKAGES is set, but OFFLINE_MODE is \"true\". Skipping Linux package installation."
+  elif [[ "$packages" != "" ]]; then
+    echo "PACKAGES is set. Installing the following additional Linux packages: ""$packages"
+    if ! bash /opt/scripts/setup_packages.sh -install; then echo "Failed."; fi
+  fi
+  echo " "
+else
+  echo "This is not the first run of this container. Skipping first run preparation."
+fi
+echo " "
+
+# Setting UID and/ or GID
+if [[ "$setgid" != "$(id -u iobroker)" || "$setuid" != "$(id -g iobroker)" ]]; then
+  echo "SETUID and/ or SETGID are set to custom values."
+  echo -n "Changing UID to \"""$setuid""\" and GID to \"""$setgid""\"... "
+    usermod -u "$setuid" iobroker
+    groupmod -og "$setgid" iobroker
+  echo "Done."
+  echo " "
+fi
+
+# Change directory for next steps
+cd /opt/iobroker
+
+#####
+# STEP 2 - Detecting ioBroker-Installation
+#####
+echo "$(printf -- '-%.0s' {1..80})"
+echo "-----             Step 2 of 5: Detecting ioBroker Installation             -----"
+echo "$(printf -- '-%.0s' {1..80})"
+echo " "
+
+if [[ `find /opt/iobroker -type f | wc -l` -lt 1 ]]; then
+  echo "There is no data detected in /opt/iobroker."
+  echo -n "Restoring initial ioBroker installation... "
+    tar -xf /opt/initial_iobroker.tar -C /
+  echo "Done."
+elif [[ -f /opt/iobroker/iobroker ]]; then
+  echo "Existing installation of ioBroker detected in \"/opt/iobroker\"."
+elif [[ "$(ls *_backupiobroker.tar.gz 2> /dev/null | wc -l)" != "0" && "$(tar -ztvf /opt/iobroker/*_backupiobroker.tar.gz "backup/backup.json" 2> /dev/null | wc -l)" != "0" ]]; then
+  echo "IoBroker backup file detected in /opt/iobroker."
+  if [[ "$debug" == "true" ]]; then echo "[DEBUG] Backup file name: " "$(ls *_backupiobroker.tar.gz)"; fi
+  echo "Since Docker image v8, automatic initial restore is no longer supported!"
+  echo "IoBroker will start with a fresh installation, while your backup file will be copied into the backup directory."
+  echo "You will be able to restore your backup file manually by using the backitup adapter or the containers maintenance script."
+  echo "For more information see ioBroker Docker image docs (https://docs.buanet.de/iobroker-docker-image/docs/)."
+  echo " "
+  echo -n "Copying backup file and restoring initial ioBroker installation... "
+    mv /opt/iobroker/*.tar.gz /opt/
+    tar -xf /opt/initial_iobroker.tar -C /
+    mkdir /opt/iobroker/backups
+    mv /opt/*.tar.gz /opt/iobroker/backups/
+    # fixing permission errors during restore
+    chown -R "$setuid":"$setgid" /opt/iobroker
+  echo "Done."
+else
+  echo "There is data detected in /opt/iobroker but it looks like it is no instance of ioBroker!"
+  if [[ "$debug" == "true" ]]; then
+    echo "[DEBUG] Detected files:"
+    ls -al
+  fi
+  echo "Please check/ recreate mounted folder or volume and try again."
+  stop_on_error
+fi
+echo " "
+
+#####
+# STEP 3 - Checking ioBroker-Installation
+#####
+echo "$(printf -- '-%.0s' {1..80})"
+echo "-----             Step 3 of 5: Checking ioBroker Installation              -----"
+echo "$(printf -- '-%.0s' {1..80})"
+echo " "
+
+# Backing up and replace original iobroker executable to fix sudo bug with gosu
+if [[ -n $(cmp /opt/scripts/iobroker.sh /opt/iobroker/iobroker) ]]; then
+  echo -n "Replacing ioBroker executable to fix sudo bug... "
+  cp -a /opt/iobroker/iobroker /opt/iobroker/iobroker.bak
+  cp -f /opt/scripts/iobroker.sh /opt/iobroker/iobroker
+  chmod 755 /opt/iobroker/iobroker
+  echo "Done."
+  echo " "
+fi
+
+# (Re)Setting permissions to "/opt/iobroker" and "/opt/scripts"
+if [[ "$permissioncheck" == "false" ]]; then
+  echo "PERMISSION_CHECK is set to false. Use this at your own risk!"
+else
+  echo -n "(Re)setting permissions (This might take a while! Please be patient!)... "
+    chown -R "$setuid":"$setgid" /opt/iobroker
+    chown -R "$setuid":"$setgid" /opt/scripts
+    chown -R "$setuid":"$setgid" /opt/userscripts
+    chown -R "$setuid":"$setgid" /opt/.docker_config
+  echo "Done."
+fi
+echo " "
+
+# Checking multihost and db setup
+if [[ "$multihost" == "master" || "$multihost" == "slave" ]]; then
+  # multihost enabled
+  if [[ "$multihost" == "master" ]]; then
+    set +e
+    bash /opt/scripts/setup_iob_db.sh -master
+    return=$?
+    set -e
+    if [[ "$return" -ne 0 ]]; then stop_on_error; fi
+  elif [[ "$multihost" == "slave" ]]; then
+    set +e
+    bash /opt/scripts/setup_iob_db.sh -slave
+    return=$?
+    set -e
+    if [[ "$return" -ne 0 ]]; then stop_on_error; fi
+  fi
+elif [[ "$multihost" == "" || "$multihost" == "false" ]]; then
+  # no multihost, only debug output
+  if [[ "$debug" == "true" ]]; then
+    echo "[DEBUG] Checking multihost settings... "
+    echo "[DEBUG] No multihost settings detected."
+    echo "[DEBUG] Done."
+    echo " "
+  fi
+  # checking custom objects db settings
+  if [[ "$objectsdbtype" != "" || "$objectsdbhost" != "" || "$objectsdbport" != "" ]]; then
+    set +e
+    bash /opt/scripts/setup_iob_db.sh -objectsdb
+    return=$?
+    set -e
+    if [[ "$return" -ne 0 ]]; then stop_on_error; fi
+  else
+    #no custom objects db settings, only debug output
+    if [[ "$debug" == "true" ]]; then
+      echo "[DEBUG] Checking custom objects db settings... "
+      echo "[DEBUG] No custom objects db settings detected."
+      echo "[DEBUG] Done."
+      echo " "
+    fi 
+  fi
+  # checking custom states db settings
+  if [[ "$statesdbtype" != "" || "$statesdbhost" != "" || "$statesdbport" != "" ]]; then
+    set +e
+    bash /opt/scripts/setup_iob_db.sh -statesdb
+    return=$?
+    set -e
+    if [[ "$return" -ne 0 ]]; then stop_on_error; fi
+  else
+    #no custom states db settings, only debug output
+    if [[ "$debug" == "true" ]]; then
+      echo "[DEBUG] Checking custom states db settings... "
+      echo "[DEBUG] No custom states db settings detected."
+      echo "[DEBUG] Done."
+      echo " "
+    fi 
+  fi
+else
+  echo "IOB_MULTIHOST is set, but the value is not valid. Please check your configuration."
+  if [[ "$debug" == "true" ]]; then echo "[DEBUG] IOB_MULTIHOST = ""$multihost"; fi
+  echo "For more information see ioBroker Docker image docs (https://docs.buanet.de/iobroker-docker-image/docs/#environment-variables-env)."
+  stop_on_error
+fi
+
+# if restored a fresh install, running "iob setup first" for database init (but not on slaves!), otherwise check database connection
+if [[ -f /opt/iobroker/.fresh_install && "$multihost" != "slave" ]]; then
+  echo -n "Initializing a fresh installation of ioBroker... "
+  if [[ ! -d "/opt/iobroker/log" ]]; then gosu iobroker mkdir "/opt/iobroker/log"; fi
+  set +e
+  gosu iobroker iob setup first > /opt/iobroker/log/iob_setup_first.log 2>&1
+  return=$?
+  set -e
+  rm -f /opt/iobroker/.fresh_install
+  if [[ "$return" -ne 0 ]]; then
+    echo "Failed."
+    echo "For more details see \"/opt/iobroker/log/iob_setup_first.log\"."
+    echo "Please check your configuration and try again."
+    stop_on_error
+  fi
+  echo "Done."
+  echo " "
+else
+  echo -n "Checking database connection... "
+  set +e
+  if gosu iobroker iob uuid &> /dev/null; then
+    echo "Done."
+    echo " "
+  else
+    errormsg=$(gosu iobroker iob uuid 2>&1 | sed 's/^/[DEBUG] /')
+    echo "Failed."
+    if [[ "$debug" == "true" ]]; then
+      echo "[DEBUG] Error message: "
+      echo "$errormsg"
+    fi
+    echo "Please check your configuration and try again."
+    echo "For more information see ioBroker Docker image docs (https://docs.buanet.de/iobroker-docker-image/docs)."
+    stop_on_error
+  fi
+  set -e
+fi
+
+# hostname check
+if [[ "$multihost" == "slave" ]]; then
+  echo "IOB_MULTIHOST is set to \"slave\". Hostname check will be skipped."
+  echo " "
+else
+  # get admin instance and hostname
+  set +e
+  admininstance=$(gosu iobroker iob list instances | grep 'enabled' | grep -m 1 -o 'system.adapter.admin..')
+  set -e
+  if [[ "$admininstance" != "" ]]; then
+    if [[ "$debug" == "true" ]]; then echo "[DEBUG] Detected admin instance is:" "$admininstance"; fi 
+    adminhostname=$(gosu iobroker iob object get "$admininstance" --pretty | grep -oP '(?<="host": ")[^"]*')
+    if [[ "$debug" == "true" ]]; then echo "[DEBUG] Detected admin hostname is:" "$adminhostname"; fi
+  else
+    set +e
+    admininstance=$(gosu iobroker iob list instances | grep 'disabled' | grep -m 1 -o 'system.adapter.admin..')
+    set -e
+    if [[ "$admininstance" != "" ]]; then
+      if [[ "$debug" == "true" ]]; then echo "[DEBUG] Detected admin instance is disabled."; fi 
+      if [[ "$debug" == "true" ]]; then echo "[DEBUG] Detected admin instance is:" "$admininstance"; fi 
+      adminhostname=$(gosu iobroker iob object get "$admininstance" --pretty | grep -oP '(?<="host": ")[^"]*')
+      if [[ "$debug" == "true" ]]; then echo "[DEBUG] Detected admin hostname is:" "$adminhostname"; fi
+    else
+      echo "There was a problem detecting the admin instance of your iobroker."
+      echo "Make sure the ioBroker installation you use has an admin instance or try again with a fresh installation and restore your configuration."
+      echo "For more details see https://docs.buanet.de/iobroker-docker-image/docs/#restore"
+      stop_on_error
+    fi
+  fi
+  # check hostname
+  if [[ "$adminhostname" != "" && "$adminhostname" != "$(hostname)" ]]; then
+    echo "Hostname in ioBroker does not match the hostname of this container."
+    echo -n "Updating hostname to \"""$(hostname)""\"... "
+      gosu iobroker iob host "$adminhostname"
+    echo "Done."
+    echo " "
+  elif [[ "$adminhostname" = "$(hostname)" ]]; then
+    echo "Hostname in ioBroker matches the hostname of this container."
+    echo "No action required."
+    echo " "
+  else
+    echo "There was a problem checking the hostname."
+    stop_on_error
+  fi
+fi
+
+# extended debug output
+if [[ "$debug" == "true" && "$multihost" != "slave" ]]; then
+  echo "[DEBUG] Collecting some more ioBroker debug information... "
+  echo " "
+  # get information and send to array
+  IFS=$'\n'
+  instances_array=("$(gosu iobroker iob list instances)")
+  repos_array=("$(gosu iobroker iob repo list)")
+  updates_array=("$(gosu iobroker iob update)")
+  # list iob instances
+  echo "[DEBUG] ##### iobroker list instances #####"
+    for i in "${instances_array[@]}"
+    do
+      echo "$i"
+    done
+  echo " "
+  echo "[DEBUG] ##### iobroker repo list #####"
+    for i in "${repos_array[@]}"
+    do
+      echo "$i"
+    done
+  echo " "
+  echo "[DEBUG] ##### iobroker update #####"
+    for i in "${updates_array[@]}"
+    do
+      echo "$i"
+    done
+  echo " "
+  unset IFS
+fi
+
+#####
+# STEP 4 - Setting up special sessting for ioBroker-adapters
+#####
+echo "$(printf -- '-%.0s' {1..80})"
+echo "-----                Step 4 of 5: Applying Special Settings                -----"
+echo "$(printf -- '-%.0s' {1..80})"
+echo " "
+
+echo "Some adapters have special requirements/ settings which can be activated by the use of environment variables."
+echo "For more information see ioBroker Docker image docs (https://docs.buanet.de/iobroker-docker-image/docs/)."
+echo " "
+
+# Checking ENV for Adminport
+if [[ "$adminport" != "" && "$multihost" != "slave" ]]; then
+  adminportold=$(gosu iobroker iob object get "$admininstance" --pretty | grep -oP '(?<="port": )[^,]*')
+  admininstanceshort=$(echo "$admininstance" | grep -m 1 -o 'admin..')
+  if [[ "$adminport" != "$adminportold" ]]; then
+    echo "IOB_ADMINPORT is set and does not match port configured in ioBroker."
+    if [[ "$debug" == "true" ]]; then echo "[DEBUG] Detected Admin Port in ioBroker: " "$adminportold"; fi
+    echo "Setting Adminport to \"""$adminport""\"... "
+      gosu iobroker iob set "$admininstanceshort" --port "$adminport"
+    echo "Done."
+    echo " "
+  fi
+fi
+
+# Checking ENV for Backitup (external database backups)
+if [[ "$backitup" == "true" ]]; then
+  echo -n "IOB_BACKITUP_EXTDB is \"true\". Unlocking features..."
+  echo "true" > /opt/.docker_config/.backitup
+  echo "true" > /opt/scripts/.docker_config/.backitup # old path, needed until changed in backitup
+  echo "Done."
+  echo " "
+fi
+
+# Checking ENV for AVAHI
+if [[ "$avahi" = "true" && "$offlinemode" = "true" ]]; then
+  echo "AVAHI is \"true\", but OFFLINE_MODE is also \"true\". Skipping Avahi daemon setup."
+elif [[ "$avahi" = "true" ]]; then
+  echo "AVAHI is \"true\". Running setup script... "
+    chmod 755 /opt/scripts/setup_avahi.sh
+    bash /opt/scripts/setup_avahi.sh
+  echo "Done."
+  echo " "
+fi
+
+# checking ENV for USBDEVICES
+if [[ "$usbdevices" != "" && "$usbdevices" != "none" ]]; then
+  echo "USBDEVICES is set."
+  IFS=';' read -ra devicearray <<< "$usbdevices"
+    for i in "${devicearray[@]}"
+    do
+      if [[ -e "$i" ]]; then
+        echo -n "Setting permissions for \"""$i""\"... "
+        chown root:dialout "$i"
+        chmod g+rw "$i"
+        echo "Done."
+        if [[ "$debug" == "true" ]]; then echo "[DEBUG] Permissions set: " "$(ls -al "$i")"; fi
+      else
+        echo "Looks like the device \"""$i""\" does not exist."
+        echo "Did you mount it correctly by using the \"--device\" option?"
+        echo "For more information see ioBroker Docker image docs (https://docs.buanet.de/iobroker-docker-image/docs/#mounting-usb-devices)."
+        stop_on_error
+      fi
+    done
+  echo " "
+fi
+
+# Checking for Userscripts in /opt/userscripts
+if [[ $(find /opt/userscripts -type f | wc -l) -lt 1 ]]; then
+  echo -n "There is no data detected in /opt/userscripts. Restoring exapmple userscripts... "
+    tar -xf /opt/initial_userscripts.tar -C /
+    chmod 755 /opt/userscripts/userscript_firststart_example.sh
+    chmod 755 /opt/userscripts/userscript_everystart_example.sh
+  echo "Done."
+elif [[ -f /opt/userscripts/userscript_firststart.sh || -f /opt/userscripts/userscript_everystart.sh ]]; then
+  if [[ -f /opt/userscripts/userscript_firststart.sh && -f /opt/.docker_config/.first_run ]]; then
+    echo "Userscript for first start detected and this is the first start of a new container."
+    echo "Running userscript_firststart.sh... "
+      chmod 755 /opt/userscripts/userscript_firststart.sh
+      if ! bash /opt/userscripts/userscript_firststart.sh; then
+        echo "Failed."
+      else
+        echo "Done."
+      fi
+  fi
+  if [[ -f /opt/userscripts/userscript_everystart.sh ]]; then
+    echo "Userscript for every start detected. Running userscript_everystart.sh... "
+      chmod 755 /opt/userscripts/userscript_everystart.sh
+      if ! bash /opt/userscripts/userscript_everystart.sh; then
+        echo "Failed."
+      else
+        echo "Done."
+      fi
+  fi
+  echo " "
+fi
+
+
+# Removing first run an fresh install markers when exists
+if [[ -f /opt/.docker_config/.first_run ]]; then rm -f /opt/.docker_config/.first_run; fi
+if [[ -f /opt/iobroker/.fresh_install ]]; then rm -f /opt/iobroker/.fresh_install; fi
+
+#####
+# STEP 5 - Starting ioBroker
+#####
+echo "$(printf -- '-%.0s' {1..80})"
+echo "-----                    Step 5 of 5: ioBroker Startup                     -----"
+echo "$(printf -- '-%.0s' {1..80})"
+echo " "
+echo "Starting ioBroker... "
+echo " "
+echo "##### #### ### ## # iobroker.js-controller log output # ## ### #### #####"
+
+# Setting healthcheck status to "running"
+echo "running" > /opt/.docker_config/.healthcheck
+
+# Function for graceful shutdown by SIGTERM signal
+shut_down() {
+  echo " "
+  echo "Recived termination signal (SIGTERM)."
+  echo "Shutting down ioBroker... "
+
+  local status timeout
+
+  timeout="$(date --date="now + ""$pkill_timeout"" sec" +%s)"
+  pkill -u iobroker -f iobroker.js-controller
+  status=$?
+  if (( status >= 2 )); then      # syntax error or fatal error
+    return 1
+  fi
+
+  if (( status == 1 )); then      # no processes matched
+    return
+  fi
+
+  # pgrep exits with status 1 when there are no matches
+  while pgrep -u iobroker > /dev/null; (( $? != 1 )); do
+    if (($(date +%s) > timeout)); then
+      echo -e "\nTimeout reached. Killing remaining processes... "
+      pkill --signal SIGKILL -u iobroker
+      echo "Done. Have a nice day!"
+      exit
+    fi
+
+    echo -n "."
+    sleep 1
+  done
+
+  echo -e '\nDone. Have a nice day!'
+  exit
+}
+
+# Trap to get signal for graceful shutdown
+trap 'shut_down' SIGTERM
+
+# IoBroker start
+gosu iobroker node node_modules/iobroker.js-controller/controller.js & wait
+
+# Fallback process for keeping container running when ioBroker is stopped for maintenance (e.g. js-controller update)
+gosu iobroker tail -f /dev/null

debian12/scripts/maintenance.sh

@@ -0,0 +1,406 @@
+#!/usr/bin/env bash
+
+# bash strict mode
+set -euo pipefail
+
+autoconfirm=      # can be set to 'yes' by command line option
+killbyname=       # can be set to 'yes' by command line option (undocumented, only for use with backitup restore scripts)
+healthcheck=/opt/.docker_config/.healthcheck      # path of healthcheck file
+pkill_timeout=10      # timeout for stopping iobroker in seconds
+
+# check for user root
+if [ "$(id -u)" -eq 0 ]; then
+  echo "WARNING! This script should be executed as user "iobroker"! Please switch user and try again."
+  exit 1
+fi
+
+# display help text
+display_help() {
+  echo "This script helps you manage your ioBroker container!"
+  echo " "
+  echo "Usage: maintenance [ COMMAND ] [ OPTION ]"
+  echo "       maint [ COMMAND ] [ OPTION ]"
+  echo "       m [ COMMAND ] [ OPTION ]"
+  echo " "
+  echo "COMMANDS"
+  echo "------------------"
+  echo "       status     > reports the current state of maintenance mode"
+  echo "       on         > switches mantenance mode ON"
+  echo "       off        > switches mantenance mode OFF and stops or restarts the container"
+  echo "       upgrade    > puts the container to maintenance mode and upgrades ioBroker"
+  echo "       restart    > stops iobroker and stops or restarts the container"
+  echo "       restore    > stops iobroker and restores the last backup"
+  echo "       help       > shows this help"
+  echo " "
+  echo "OPTIONS"
+  echo "------------------"
+  echo "       -y|--yes   > confirms the used command without asking"
+  echo "       -h|--help  > shows this help"
+  echo " "
+}
+
+# check maintenance enabled
+maintenance_enabled() {
+  [[ -f "$healthcheck" && "$(cat "$healthcheck")" == maintenance ]]
+}
+
+# check status starting
+check_starting() {
+  [[ -f "$healthcheck" && "$(cat "$healthcheck")" == starting ]]
+}
+
+# display maintenance status
+maintenance_status() {
+  if maintenance_enabled; then
+    echo "Maintenance mode is turned ON."
+  else
+    echo "Maintenance mode is turned OFF."
+  fi
+}
+
+# enable maintenance mode
+enable_maintenance() {
+  if maintenance_enabled; then
+    echo "Maintenance mode is already turned ON."
+    return
+  fi
+
+  echo "You are now going to stop ioBroker and activate maintenance mode for this container."
+
+  if [[ "$killbyname" != yes ]]; then
+    if [[ "$autoconfirm" != yes ]]; then
+      local reply
+
+      read -rp 'Do you want to continue [yes/no]? ' reply
+      if [[ "$reply" == y || "$reply" == Y || "$reply" == yes ]]; then
+      : # continue
+      else
+        return 1
+      fi
+    fi
+  fi
+
+  echo "Activating maintenance mode..."
+  echo "maintenance" > "$healthcheck"
+  sleep 1
+  echo -n "Stopping ioBroker..."
+  stop_iob
+}
+
+# disable maintenance mode
+disable_maintenance() {
+  if ! maintenance_enabled; then
+    echo "Maintenance mode is already turned OFF."
+    return
+  fi
+
+  echo "You are now going to deactivate maintenance mode for this container."
+  echo "Depending on the restart policy, your container will be stopped or restarted immediately."
+
+  if [[ "$autoconfirm" != yes ]]; then
+    local reply
+
+    read -rp 'Do you want to continue [yes/no]? ' reply
+    if [[ "$reply" == y || "$reply" == Y || "$reply" == yes ]]; then
+      : # continue
+    else
+      return 1
+    fi
+  fi
+
+  echo "Deactivating maintenance mode and forcing container to stop or restart..."
+  echo "stopping" > "$healthcheck"
+  pkill -u iobroker
+  echo "Done."
+}
+
+# upgrade js-controller
+upgrade_jscontroller() {
+  echo "You are now going to upgrade your js-controller."
+  echo "As this will change data in /opt/iobroker, make sure you have a backup!"
+  echo "During the upgrade process, the container will automatically switch into maintenance mode and stop ioBroker."
+  echo "Depending on the restart policy, your container will be stopped or restarted automatically after the upgrade."
+
+  if [[ "$autoconfirm" != yes ]]; then
+    local reply
+
+    read -rp 'Do you want to continue [yes/no]? ' reply
+    if [[ "$reply" == y || "$reply" == Y || "$reply" == yes ]]; then
+      : # continue
+    else
+      return 1
+    fi
+  fi
+
+  if ! maintenance_enabled > /dev/null; then
+    autoconfirm=yes
+    enable_maintenance
+  fi
+
+  echo "Upgrading js-controller..."
+  iobroker update
+  sleep 1
+  iobroker upgrade self
+  sleep 1
+  echo "Done."
+
+  echo "Container will be stopped or restarted in 5 seconds..."
+  sleep 5
+  echo "stopping" > "$healthcheck"
+  pkill -u iobroker
+}
+
+# stop iobroker and wait until all processes stopped or pkill_timeout is reached
+stop_iob() {
+  local status timeout
+
+  timeout="$(date --date="now + $pkill_timeout sec" +%s)"
+  pkill -u iobroker -f 'iobroker.js-controller[^/]*$'
+  status=$?
+  if (( status >= 2 )); then      # syntax error or fatal error
+    return 1
+  elif (( status == 1 )); then      # no processes matched
+    return
+  fi
+
+  if [[ "$killbyname" != yes ]]; then
+    # pgrep exits with status 1 when there are no matches
+    while pgrep -u iobroker -f 'io\..' > /dev/null; (( $? != 1 )); do
+      if (($(date +%s) > timeout)); then
+        echo -e "\nTimeout reached. Killing remaining processes..."
+        pgrep --list-full -u iobroker -f 'io\..'
+        pkill --signal SIGKILL -u iobroker -f 'io\..'
+        echo "Done."
+        return
+      fi
+      sleep 1
+      echo -n "."
+    done
+  else
+    for ((i=0; i<3; i++)); do
+      sleep 1
+      echo -n "."
+    done
+  fi
+
+  echo -e "Done."
+  echo " "
+}
+
+# restart container
+restart_container() {
+  echo "You are now going to call a restart of your container."
+  echo "Restarting will work depending on the configured restart policy."
+
+  if [[ "$autoconfirm" != yes ]]; then
+    local reply
+
+    read -rp 'Do you want to continue [yes/no]? ' reply
+    if [[ "$reply" == y || "$reply" == Y || "$reply" == yes ]]; then
+      : # continue
+    else
+      return 1
+    fi
+  fi
+
+  if ! maintenance_enabled > /dev/null; then
+    echo -n "Stopping ioBroker..."
+    stop_iob
+  fi
+
+  echo "Container will be stopped or restarted in 5 seconds..."
+  sleep 5
+  echo "stopping" > "$healthcheck"
+  pkill -u iobroker
+}
+
+# restore iobroker
+restore_iobroker() {
+  echo "You are now going to perform a restore of your iobroker."
+  echo "During the restore process, the container will automatically switch into maintenance mode and stop ioBroker."
+  echo "Depending on the restart policy, your container will be stopped or restarted automatically after the restore."
+  
+  # check autoconfirm
+  if [[ "$autoconfirm" != yes ]]; then
+    local reply
+    read -rp 'Do you want to continue [yes/no]? ' reply
+    if [[ "$reply" != y && "$reply" != Y && "$reply" != yes ]]; then
+        return 1
+    fi
+  fi
+  echo " "
+
+  # check startup script running
+  if check_starting > /dev/null; then
+    echo "Startup script is still running."
+    echo "Please check container log and wait until ioBroker is sucessfully started."
+    return 1
+  fi
+
+  # check mainenance mode
+  if ! maintenance_enabled > /dev/null; then
+    autoconfirm=yes
+    enable_maintenance
+  fi
+
+  # list backup files
+  backup_dir="/opt/iobroker/backups"
+  backup_files=($(find $backup_dir -type f))
+  backup_count=${#backup_files[@]}
+
+  if [[ $backup_count -eq 0 ]]; then
+      echo "Ther are no backup files in $backup_dir."
+      echo "Please check and try again."
+      return 1
+  elif [[ $backup_count -eq 1 ]]; then
+      selected_backup=$(basename "${backup_files[0]}")
+      echo "Selected backup file is \"$selected_backup\"."
+  else
+      # more than one backup file found, ask user to select
+      echo "There are more than one backup file in \"$backup_dir\"."
+      echo ' ' 
+      echo "Please select file for restore:"
+      for ((i=0; i<$backup_count; i++)); do
+        echo "$i: $(basename "${backup_files[$i]}")"
+      done
+      echo
+
+      read -rp "Enter the number of the backup to restore (0-$((backup_count - 1))): " selected_number
+      selected_backup=$(basename "${backup_files[$selected_number]}")
+      echo ' '
+      echo "Selected backup file is \"$selected_backup\"."
+      echo ' '
+  fi
+
+  # extract backup.json from backup
+  tar -xvzf $backup_dir/$selected_backup -C $backup_dir --strip-components=1 "backup/backup.json" > /dev/null 2>&1
+  # write js-controller versions from backup.json into array
+  jq_output=$(jq --arg TITLE "JS controller" -r '.objects[] | select(.value.common.title == $TITLE)' $backup_dir/backup.json)
+  # remove backup.json
+  rm $backup_dir/backup.json
+
+  result=()
+  while read -r line; do
+    entry=$(echo "$line" | jq -r '.value.common.installedVersion')
+    result+=("$entry")
+  done <<< "$(echo "$jq_output" | jq -c '.')"
+
+  # check for empty array
+  if [[ "${#result[@]}" -eq 0 ]]; then
+    echo "There was a problem detecting the js-controller version in the seclected backup file."
+    return 1
+  else
+    # check if all found js-controller versions are equal (for multihost systems!)
+    first_version=${result[0]}
+    all_versions_equal=true
+    for i in "${result[@]}"; do
+      version=$i
+      if [[ "$version" != "$first_version" ]]; then
+        all_versions_equal=false
+        break
+      fi
+    done
+
+    if [[ "$all_versions_equal" != true ]]; then
+      echo "Detected different js-controller versions in the selected backup file."
+      return 1
+    fi
+  fi
+   
+  # compare installed js-controller version with version from backup file
+  echo -n "Checking js-controller versions... "
+  installed_version=$(iob version js-controller)
+  echo "Done."
+  echo ' '
+  echo "Installed js-controller version:  $installed_version"
+  echo "Backup js-controller version:     $first_version"
+  echo ' '
+
+  if [[ "$first_version" != "$installed_version" ]]; then
+    echo "The installed js-controller version is different from the version in the selected backup file."
+    echo "If you continue, the script will use the \"--force\" option to restore your backup."
+    echo "Although this is normally safe with small version differences, you should know,"
+    echo "that the recommended way is to first install the same js-controller version before restoring the backup file."
+    local reply
+    read -rp 'Do you want to continue [yes/no]? ' reply
+    if [[ "$reply" != y && "$reply" != Y && "$reply" != yes ]]; then
+        return 1
+    fi
+  fi
+
+  echo -n "Restoring ioBroker from \"$selected_backup\"... "
+
+  set +e
+  bash iobroker restore "$selected_backup" --force > /opt/iobroker/log/restore.log 2>&1
+  return_value=$?
+  set -e
+
+  if [[ "$return_value" -ne 0 ]]; then
+      echo "Failed."
+      echo "For more details see \"/opt/iobroker/log/restore.log\"."
+      echo "Please check backup file location and permissions and try again."
+      return 1
+  fi
+  echo "Done."
+  echo " "
+  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+  echo "!!!!                             IMPORTANT NOTE                             !!!!"
+  echo "!!!!      The maintenance script restored iobroker from a backup file.      !!!!"
+  echo "!!!! Check /opt/iobroker/log/restore.log to see if restore was successful.  !!!!"
+  echo "!!!!   When ioBroker starts it will reinstall all Adapters automatically.   !!!!"
+  echo "!!!!         This might be take a looooong time! Please be patient!         !!!!"
+  echo "!!!!  You can view installation process by taking a look at ioBroker log.   !!!!"
+  echo "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+  sleep 10
+  echo "Container will be stopped or restarted in 10 seconds..."
+  echo "stopping" > "$healthcheck"
+  sleep 10
+  pkill -u iobroker
+}
+
+# parsing commands and options
+
+# default command to run unless another was given
+run=(display_help)
+
+for arg in "$@"; do
+  case $arg in
+    help|-h|--help)
+      run=(display_help)
+      ;;
+    status|stat|s)
+      run=(maintenance_status)
+      ;;
+    on)
+      run=(enable_maintenance)
+      ;;
+    off)
+      run=(disable_maintenance)
+      ;;
+    upgrade|upgr|u)
+      run=(upgrade_jscontroller)
+      ;;
+    restart|rest|r)
+      run=(restart_container)
+      ;;
+    restore)
+      run=(restore_iobroker)
+      ;;
+    -y|--yes)
+      autoconfirm=yes
+      ;;
+    -kbn|--killbyname)
+      killbyname=yes
+      ;;
+    --)
+      break
+      ;;
+    *)
+      >&2 echo "Unknown parameter: $arg"
+      >&2 echo "Please try again or see help (help|-h|--help)."
+      exit 1
+      ;;
+  esac
+done
+
+"${run[@]}"

debian12/scripts/setup_avahi.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+if [ -e /usr/sbin/avahi-daemon ] && [ -e /var/run/dbus ]
+then
+  echo "[setup_avahi.sh] Avahi is already installed. Nothing to do here."
+else
+  echo -n "[setup_avahi.sh] Avahi-daemon is NOT installed. Going to install it now... "
+    apt-get -q update > /opt/scripts/avahi_startup.log 2>&1
+    apt-get -q -y --no-install-recommends install libavahi-compat-libdnssd-dev avahi-daemon >> /opt/scripts/avahi_startup.log 2>&1
+    # Silent Cleanup
+    apt-get -qq autoclean -y && apt-get -qq autoremove && apt-get -qq clean
+    rm -rf /tmp/* /var/tmp/* /root/.cache/* /var/lib/apt/lists/* || true
+  echo "Done."
+  echo -n "[setup_avahi.sh] Configuring avahi-daemon... "
+    sed -i '/^rlimit-nproc/s/^\(.*\)/#\1/g' /etc/avahi/avahi-daemon.conf
+  echo "Done."
+  echo -n "[setup_avahi.sh] Configuring dbus... "
+    mkdir /var/run/dbus/
+  echo "Done."
+fi
+
+if [ -f /var/run/dbus/pid ];
+then
+  rm -f /var/run/dbus/pid
+fi
+
+if [ -f /var/run/avahi-daemon//pid ];
+then
+  rm -f /var/run/avahi-daemon//pid
+fi
+
+echo -n "[setup_avahi.sh] Starting dbus... "
+  dbus-daemon --system >> /opt/scripts/avahi_startup.log 2>&1
+echo "Done."
+
+echo -n "[setup_avahi.sh] Starting avahi-daemon... "
+  avahi-daemon >> /opt/scripts/avahi_startup.log 2>&1 &
+echo "Done."
+
+exit 0

debian12/scripts/setup_iob_db.sh

@@ -0,0 +1,357 @@
+#!/usr/bin/env bash
+
+# reading env
+debug=$DEBUG
+objectsdbhost=$IOB_OBJECTSDB_HOST
+objectsdbport=$IOB_OBJECTSDB_PORT
+objectsdbtype=$IOB_OBJECTSDB_TYPE
+objectsdbname=$IOB_OBJECTSDB_NAME # new for sentinel support
+objectsdbpass=$IOB_OBJECTSDB_PASS # new for auth support
+setgid=$SETGID
+setuid=$SETUID
+statesdbhost=$IOB_STATESDB_HOST
+statesdbport=$IOB_STATESDB_PORT
+statesdbtype=$IOB_STATESDB_TYPE
+statesdbname=$IOB_STATESDB_NAME # new for sentinel support
+statesdbpass=$IOB_STATESDB_PASS # new for auth support
+
+# functions
+write_iobroker_json() {
+  mv /opt/iobroker/iobroker-data/iobroker.json.tmp /opt/iobroker/iobroker-data/iobroker.json
+  chown -R "$setuid":"$setgid" /opt/iobroker/iobroker-data/iobroker.json && chmod 674 /opt/iobroker/iobroker-data/iobroker.json
+}
+set_objectsdb_type() {
+  if [[ "$objectsdbtype" != "$(jq -r '.objects.type' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+    echo "IOB_OBJECTSDB_TYPE is available but value is different from detected ioBroker installation."
+    echo -n "Setting type of objects db to \"""$objectsdbtype""\"... "
+      jq --arg value "$objectsdbtype" '.objects.type = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+      write_iobroker_json
+    echo "Done."
+  else
+    echo "IOB_OBJECTSDB_TYPE is available and value meets detected ioBroker installation."
+  fi
+}
+set_objectsdb_host() {
+  if [[ $objectsdbhost == *","* ]]; then
+    if [[ "$(jq -c -n --arg value "$objectsdbhost" '$value|split(",")')" != "$(jq -r '.objects.host' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+      echo "IOB_OBJECTSDB_HOST is available but value is different from detected ioBroker installation."
+      echo -n "Setting host of objects db to \"""$objectsdbhost""\"... "
+        jq --arg value "$objectsdbhost" '.objects.host = ($value|split(","))' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "IOB_OBJECTSDB_HOST is available and value meets detected ioBroker installation."
+    fi
+    if [[ $objectsdbname != "" ]]; then
+      if [[ "$objectsdbname" != "$(jq -r '.objects.sentinelName' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+        echo "IOB_OBJECTSDB_NAME is available but value is different from detected ioBroker installation."
+        echo -n "Setting name of objects db to \"""$objectsdbname""\"... "
+          jq --arg value "$objectsdbname" '.objects.sentinelName = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+          write_iobroker_json
+        echo "Done."
+      else
+        echo "IOB_OBJECTSDB_NAME is available and value meets detected ioBroker installation."
+      fi
+    else
+      if [[ "$(jq -r '.objects.sentinelName' /opt/iobroker/iobroker-data/iobroker.json)" != "mymaster" ]]; then
+        echo "IOB_OBJECTSDB_NAME is not available. Using default value \"mymaster\" instead."
+        echo -n "Setting name of objects db to \"mymaster\"... "
+          jq --arg value "mymaster" '.objects.sentinelName = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+          write_iobroker_json
+        echo "Done."
+      else
+        echo "IOB_OBJECTSDB_NAME is not available but default value \"mymaster\" meets detected ioBroker installation.."
+      fi
+    fi
+  else
+    if [[ "$objectsdbhost" != "$(jq -r '.objects.host' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+      echo "IOB_OBJECTSDB_HOST is available but value is different from detected ioBroker installation."
+      echo -n "Setting host of objects db to \"""$objectsdbhost""\"... "
+        jq --arg value "$objectsdbhost" '.objects.host = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "IOB_OBJECTSDB_HOST is available and value meets detected ioBroker installation."
+    fi
+  fi
+}
+set_objectsdb_port() {
+  if [[ $objectsdbport == *","* ]]; then 
+    if [[ "$(jq -c -n --arg value "$objectsdbport" '$value|split(",")')" != "$(jq -r '.objects.port' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+      echo "IOB_OBJECTSDB_PORT is available but value is different from detected ioBroker installation."
+      echo -n "Setting port of objects db to \"""$objectsdbport""\"... "
+        jq --arg value "$objectsdbport" '.objects.port = ($value|split(","))' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "IOB_OBJECTSDB_PORT is available and value meets detected ioBroker installation."
+    fi
+  else
+    if [[ "$objectsdbport" != "$(jq -r '.objects.port' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+      echo "IOB_OBJECTSDB_PORT is available but value is different from detected ioBroker installation."
+      echo -n "Setting port of objects db to \"""$objectsdbport""\"... "
+        jq --arg value "$objectsdbport" '.objects.port = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "IOB_OBJECTSDB_PORT is available and value meets detected ioBroker installation."
+    fi
+  fi
+}
+set_objectsdb_pass() {
+  if [[ "$objectsdbpass" == "none" ]]; then
+    echo "IOB_OBJECTSDB_PASS is available but value is set to \"none\"."
+    echo -n "Removing password of objects db... "
+      jq '.objects.options.auth_pass = null' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+      write_iobroker_json
+    echo "Done."
+  elif [[ "$objectsdbpass" != "$(jq -r '.objects.options.auth_pass' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+    echo "IOB_OBJECTSDB_PASS is available but value is different from detected ioBroker installation."
+    echo -n "Setting password of objects db... "
+      jq --arg value "$objectsdbpass" '.objects.options.auth_pass = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+      write_iobroker_json
+    echo "Done."
+  else
+  echo "IOB_OBJECTSDB_PASS is available and value meets detected ioBroker installation."
+  fi
+}
+set_statesdb_type() {
+  if [[ "$statesdbtype" != "$(jq -r '.states.type' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+    echo "IOB_STATESDB_TYPE is available but value is different from detected ioBroker installation."
+    echo -n "Setting type of states db to \"""$statesdbtype""\"... "
+      jq --arg value "$statesdbtype" '.states.type = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+      write_iobroker_json
+    echo "Done."
+  else
+    echo "IOB_STATESDB_TYPE is available and value meets detected ioBroker installation."
+  fi
+}
+set_statesdb_host() {
+  if [[ $statesdbhost == *","* ]]; then
+    if [[ "$(jq -c -n --arg parm "$statesdbhost" '$parm|split(",")')" != "$(jq -r '.states.host' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+      echo "IOB_STATESDB_HOST is available but value is different from detected ioBroker installation."
+      echo -n "Setting host of states db to \"""$statesdbhost""\"... "
+        jq --arg value "$statesdbhost" '.states.host = ($value|split(","))' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "IOB_STATESDB_HOST is available and value meets detected ioBroker installation."
+    fi
+    if [[ $statesdbname != "" ]]; then
+      if [[ "$statesdbname" != "$(jq -r '.states.sentinelName' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+        echo "IOB_STATESDB_NAME is available but value is different from detected ioBroker installation."
+        echo -n "Setting name of states db to \"""$statesdbname""\"... "
+          jq --arg value "$statesdbname" '.states.sentinelName = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+          write_iobroker_json
+        echo "Done."
+      else
+        echo "IOB_STATESDB_NAME is available and value meets detected ioBroker installation."
+      fi
+    else
+      if [[ "$(jq -r '.states.sentinelName' /opt/iobroker/iobroker-data/iobroker.json)" != "mymaster" ]]; then
+        echo "IOB_STATESDB_NAME is not available. Using default value \"mymaster\" instead."
+        echo -n "Setting name of states db to \"mymaster\"... "
+          jq --arg value "mymaster" '.states.sentinelName = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+          write_iobroker_json
+        echo "Done."
+      else
+        echo "IOB_STATESDB_NAME is not available but default value \"mymaster\" meets detected ioBroker installation.."
+      fi
+    fi
+  else
+    if [[ "$statesdbhost" != "$(jq -r '.states.host' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+      echo "IOB_STATESDB_HOST is available but value is different from detected ioBroker installation."
+      echo -n "Setting host of states db to \"""$statesdbhost""\"... "
+        jq --arg value "$statesdbhost" '.states.host = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "IOB_STATESDB_HOST is available and value meets detected ioBroker installation."
+    fi
+  fi
+}
+set_statesdb_port() {
+  if [[ $statesdbport == *","* ]]; then 
+    if [[ "$(jq -c -n --arg value "$statesdbport" '$value|split(",")')" != "$(jq -r '.states.port' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+      echo "IOB_STATESDB_PORT is available but value is different from detected ioBroker installation."
+      echo -n "Setting port of states db to \"""$statesdbport""\"... "
+        jq --arg value "$statesdbport" '.states.port = ($value|split(","))' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "IOB_STATESDB_PORT is available and value meets detected ioBroker installation."
+    fi
+  else
+    if [[ "$statesdbport" != "$(jq -r '.states.port' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+      echo "IOB_STATESDB_PORT is available but value is different from detected ioBroker installation."
+      echo -n "Setting port of states db to \"""$statesdbport""\"... "
+        jq --arg value "$statesdbport" '.states.port = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "IOB_STATESDB_PORT is available and value meets detected ioBroker installation."
+    fi
+  fi
+}
+set_statesdb_pass() {
+  if [[ "$statesdbpass" == "none" ]]; then
+    echo "IOB_STATESDB_PASS is available but value is set to \"none\"."
+    echo -n "Removing password of states db... "
+      jq '.states.options.auth_pass = null' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+      write_iobroker_json
+    echo "Done."
+  elif [[ "$statesdbpass" != "$(jq -r '.states.options.auth_pass' /opt/iobroker/iobroker-data/iobroker.json)" ]]; then
+    echo "IOB_STATESDB_PASS is available but value is different from detected ioBroker installation."
+    echo -n "Setting password of states db... "
+      jq --arg value "$statesdbpass" '.states.options.auth_pass = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp
+      write_iobroker_json
+    echo "Done."
+  else
+    echo "IOB_STATESDB_PASS is available and value meets detected ioBroker installation."
+  fi
+}
+config_error_output() {
+  echo " "
+  echo "Something went wrong. Looks like at least one parameter defining the custom db connection was not set properly or is missing."
+  echo "Please check your configuration and try again."
+  echo "For more information see ioBroker Docker Image Docs (https://docs.buanet.de/iobroker-docker-image/docs/)."
+}
+
+# parameter check
+if [[ "$1" == "-master" ]]; then # setup master
+  echo "IOB_MULTIHOST is available and set to \"master\"."
+  echo "Done."
+  echo " "
+  # multihost objects db
+  if [[ "$objectsdbtype" != "" && "$objectsdbhost" != "" && "$objectsdbport" != "" ]]; then
+    echo "Configuring custom objects db..."
+    set_objectsdb_type
+    set_objectsdb_host
+    set_objectsdb_port
+    if [[ "$objectsdbpass" != "" ]]; then set_objectsdb_pass; fi
+    echo "Done."
+    echo " "
+  elif [[ "$objectsdbtype" == "" && "$objectsdbhost" == "" && "$objectsdbport" == "" ]]; then
+    echo "No custom objects db is set."
+    if [[ "$(jq -r '.objects.host' /opt/iobroker/iobroker-data/iobroker.json)" != "0.0.0.0" ]]; then
+      echo -n "Configuring default objects db to accept external connections... "
+        jq --arg value "0.0.0.0" '.objects.host = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp 
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "Default objects db is accepting external connections."
+    fi
+  else
+    if [[ "$debug" == "true" ]]; then
+      echo "[DEBUG] IOB_OBJECTSDB_TYPE = ""$objectsdbtype"
+      echo "[DEBUG] IOB_OBJECTSDB_HOST = ""$objectsdbhost"
+      echo "[DEBUG] IOB_OBJECTSDB_PORT = ""$objectsdbport"
+    fi
+    config_error_output
+    exit 1
+  fi
+  # multihost states db
+  if [[ "$statesdbtype" != "" && "$statesdbhost" != "" && "$statesdbport" != "" ]]; then
+    echo "Configuring custom states db..."
+    set_statesdb_type
+    set_statesdb_host
+    set_statesdb_port
+    if [[ "$statesdbpass" != "" ]]; then set_statesdb_pass; fi
+    echo "Done."
+    echo " "
+  elif [[ "$statesdbtype" == "" && "$statesdbhost" == "" && "$statesdbport" == "" ]]; then
+    echo "No custom states db is set."
+    if [[ "$(jq -r '.states.host' /opt/iobroker/iobroker-data/iobroker.json)" != "0.0.0.0" ]]; then
+      echo -n "Configuring default states db to accept external connections... "
+        jq --arg value "0.0.0.0" '.states.host = $value' /opt/iobroker/iobroker-data/iobroker.json > /opt/iobroker/iobroker-data/iobroker.json.tmp 
+        write_iobroker_json
+      echo "Done."
+    else
+      echo "Default states db is accepting external connections."
+    fi
+  else
+    if [[ "$debug" == "true" ]]; then
+      echo "[DEBUG] IOB_STATESDB_TYPE = ""$statesdbtype"
+      echo "[DEBUG] IOB_STATESDB_HOST = ""$statesdbhost"
+      echo "[DEBUG] IOB_STATESDB_PORT = ""$statesdbport"
+    fi
+    config_error_output
+    exit 1
+  fi
+elif [[ "$1" == "-slave" ]]; then # setup slave
+  echo "IOB_MULTIHOST is available and set to \"slave\"."
+  echo "Done."
+  echo " "
+  # multihost slave objects db connection
+  if [[ "$objectsdbtype" != "" && "$objectsdbhost" != "" && "$objectsdbport" != "" ]]; then
+    echo "Configuring objects db connection..."
+    set_objectsdb_type
+    set_objectsdb_host
+    set_objectsdb_port
+    if [[ "$objectsdbpass" != "" ]]; then set_objectsdb_pass; fi
+    echo "Done."
+    echo " "
+  else
+    if [[ "$debug" == "true" ]]; then
+      echo "[DEBUG] IOB_OBJECTSDB_TYPE = ""$objectsdbtype"
+      echo "[DEBUG] IOB_OBJECTSDB_HOST = ""$objectsdbhost"
+      echo "[DEBUG] IOB_OBJECTSDB_PORT = ""$objectsdbport"
+    fi
+    config_error_output
+    exit 1
+  fi
+  # multihost slave states db connection
+  if [[ "$statesdbtype" != "" && "$statesdbhost" != "" && "$statesdbport" != "" ]]; then
+    echo "Configuring states db connection..."
+    set_statesdb_type
+    set_statesdb_host
+    set_statesdb_port
+    if [[ "$statesdbpass" != "" ]]; then set_statesdb_pass; fi
+    echo "Done."
+    echo " "
+  else
+    if [[ "$debug" == "true" ]]; then
+      echo "[DEBUG] IOB_STATESDB_TYPE = ""$statesdbtype"
+      echo "[DEBUG] IOB_STATESDB_HOST = ""$statesdbhost"
+      echo "[DEBUG] IOB_STATESDB_PORT = ""$statesdbport"
+    fi
+    config_error_output
+    exit 1
+  fi
+elif [[ "$1" == "-objectsdb" ]]; then # setup objects db standalone
+  if [[ "$objectsdbtype" != "" && "$objectsdbhost" != "" && "$objectsdbport" != "" ]]; then
+    echo "Configuring custom objects db..."
+    set_objectsdb_type
+    set_objectsdb_host
+    set_objectsdb_port
+    if [[ "$objectsdbpass" != "" ]]; then set_objectsdb_pass; fi
+    echo "Done."
+    echo " "
+  else
+    if [[ "$debug" == "true" ]]; then
+    echo "[DEBUG] IOB_OBJECTSDB_TYPE = ""$objectsdbtype"
+    echo "[DEBUG] IOB_OBJECTSDB_HOST = ""$objectsdbhost"
+    echo "[DEBUG] IOB_OBJECTSDB_PORT = ""$objectsdbport"
+    fi
+    config_error_output
+    exit 1
+  fi
+elif [[ "$1" == "-statesdb" ]]; then # setup states db standalone
+  if [[ "$statesdbtype" != "" && "$statesdbhost" != "" && "$statesdbport" != "" ]]; then
+    echo "Configuring custom states db..."
+    set_statesdb_type
+    set_statesdb_host
+    set_statesdb_port
+    if [[ "$statesdbpass" != "" ]]; then set_statesdb_pass; fi
+    echo "Done."
+    echo " "
+  else
+    if [[ "$debug" == "true" ]]; then
+    echo "[DEBUG] IOB_STATESDB_TYPE = ""$statesdbtype"
+    echo "[DEBUG] IOB_STATESDB_HOST = ""$statesdbhost"
+    echo "[DEBUG] IOB_STATESDB_PORT = ""$statesdbport"
+    fi
+    config_error_output
+    exit 1
+  fi
+fi

debian12/scripts/setup_packages.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+
+# bash strict mode
+set -euo pipefail
+
+# Reading ENV
+set +u
+packages=$PACKAGES
+debug=$DEBUG
+set -u
+
+export DEBIAN_FRONTEND=noninteractive
+
+check_package_preq() {
+  # check for influx packages
+  if [[ "$i" == "influxdb" || "$i" == "influxdb2-cli" ]]; then
+    # add influxdata repo keys
+    wget -qO- https://repos.influxdata.com/influxdata-archive_compat.key | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg > /dev/null
+    echo "deb [signed-by=/etc/apt/trusted.gpg.d/influxdata-archive_compat.gpg] https://repos.influxdata.com/debian stable main" | sudo tee /etc/apt/sources.list.d/influxdata.list
+    apt-get -q update >> /opt/scripts/setup_packages.log 2>&1
+  fi
+}
+check_package_validity() {
+  # check string for double spaces
+  while echo "$packages" | grep -q '  '; do
+    packages=$(echo "$packages" | sed 's/  / /g')
+  done
+  # remove packages when "influxdb" AND "influxdb2-cli"
+  if echo "$packages" | grep -qw "influxdb" && echo "$packages" | grep -qw "influxdb2-cli"; then
+    echo "PACKAGES includes influxdb AND influxdb2-cli."
+    echo "As installing both packages together is not possible, they will be skipped."
+    packages=$(echo "$packages" | sed 's/influxdb2-cli//g;s/influxdb//g')
+    # check string for double spaces again
+    while echo "$packages" | grep -q '  '; do
+      packages=$(echo "$packages" | sed 's/  / /g')
+    done
+    if [[ $debug == "true" ]]; then echo "[DEBUG] New list of packages: ""$packages"; fi
+    echo " "
+  fi
+}
+
+if [[ "$1" == "-install" ]]; then
+  echo " "
+  apt-get -q update >> /opt/scripts/setup_packages.log 2>&1
+  check_package_validity
+  for i in $packages; do
+    if ! dpkg -s "$i" >/dev/null 2>&1; then
+      echo -n "$i is not installed. Installing... "
+      check_package_preq >> /opt/scripts/setup_packages.log 2>&1
+      if ! apt-get -q -y --no-install-recommends install "$i" >> /opt/scripts/setup_packages.log 2>&1; then
+        echo "Failed."
+        echo "For more details see \"/opt/scripts/setup_packages.log\"."
+      else
+        echo "Done."
+      fi
+    else
+      echo "$i is already installed."
+    fi
+  done
+elif [[ "$1" == "-update" ]]; then
+  echo -n "PACKAGES_UPDATE is set. Updating Linux packages on first run... "
+  apt-get -q update >> /opt/scripts/setup_packages.log 2>&1
+  return1=$?
+  apt-get -q -y upgrade >> /opt/scripts/setup_packages.log 2>&1
+  return2=$?
+  if [[ "$return1" -ne 0 || "$return2" -ne 0 ]]; then
+    echo "Failed."
+    echo "For more details see \"/opt/scripts/setup_packages.log\"."
+    echo "Make sure the container has internet access to get the latest package updates."
+    echo "This has no impact to the setup process. The script will continue."
+  else
+    echo "Done."
+  fi
+else
+  echo "No paramerter found!"
+  exit 1
+fi
+
+# Silent Cleanup
+apt-get -qq autoclean -y && apt-get -qq autoremove && apt-get -qq clean
+rm -rf /tmp/* /var/tmp/* /root/.cache/* /var/lib/apt/lists/* || true
+
+exit 0

debian12/userscripts/userscript_everystart_example.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+# This is an example script file.
+# To run the Script on every start of the container you have to rename it to userscript_everystart.sh.
+
+# You can add your advanced script code here!
+
+echo " "
+echo "I'm your startscript userscript_everystart.sh. I will run on EVERY container startup."
+echo " "
+
+
+exit 0

debian12/userscripts/userscript_firststart_example.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+
+# This is an example script file.
+# To run the Script on the first start of a new container you have to rename it to userscript_firststart.sh.
+
+# You can add your advanced script code here!
+
+echo " "
+echo "I'm your startscript userscript_firststart.sh. I will run only on the FIRST startup of the container."
+echo " "
+
+exit 0

docs/README_docker_hub_buanet.md

@@ -0,0 +1,150 @@
+<img src="https://github.com/buanet/ioBroker.docker/raw/main/docs/img/iobroker_logo.png" width="600" title="ioBroker Logo">
+
+[![Release](https://img.shields.io/github/v/release/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/releases)
+[![Pre-Release)](https://img.shields.io/github/v/tag/buanet/ioBroker.docker?include_prereleases&label=pre-release)](https://github.com/buanet/ioBroker.docker/releases)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/buanet/ioBroker.docker/build-debian12-latest.yml?branch=main)](https://github.com/buanet/ioBroker.docker/actions/workflows/build-debian12-latest.yml)
+[![Github Issues](https://img.shields.io/github/issues/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/issues)
+[![Github Pull Requests](https://img.shields.io/github/issues-pr/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/pulls)
+[![GitHub Discussions](https://img.shields.io/github/discussions/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/discussions)<br>
+[![Arch](https://img.shields.io/badge/arch-amd64%20%7C%20arm32v7%20%7C%20arm64v8-blue)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Image Size (tag)](https://img.shields.io/docker/image-size/buanet/iobroker/latest?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Pulls](https://img.shields.io/docker/pulls/buanet/iobroker?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Stars](https://img.shields.io/docker/stars/buanet/iobroker?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)<br>
+[![Source](https://img.shields.io/badge/source-github-blue?style=flat)](https://github.com/buanet/ioBroker.docker)
+[![GitHub forks](https://img.shields.io/github/forks/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/network)
+[![GitHub stars](https://img.shields.io/github/stars/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/stargazers)
+[![License](https://img.shields.io/github/license/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/blob/master/LICENSE.md)
+[![Donate](https://img.shields.io/badge/donate-paypal-blue?style=flat)](https://paypal.me/buanet)
+
+# Important note
+
+New major image versions (e.g. v6, v7, v8) usually include a new major version of node! Although js-controller should handle this kind of upgrade fine, in some cases this still results in problems with some adapters. To avoid having trouble with this major version upgrades, it is always a good move to upgrade your container manually with backup and restore procedure. For more details please see the maintenance part of the [ioBroker Docker image docs](https://docs.buanet.de/iobroker-docker-image/docs/#maintenance).
+
+# Quick reference
+
+* Maintained by: [buanet](https://github.com/buanet) and [ioBroker](https://github.com/ioBroker)
+* Where to get support: [ioBroker forum](https://forum.iobroker.net/), [Discord channel](https://discord.gg/5jGWNKnpZ8), [Facebook group](https://www.facebook.com/groups/440499112958264)
+* Where to report issues: [Github Repository Issues](https://github.com/buanet/ioBroker.docker/issues)
+* Supported architectures: amd64, arm32v7, arm64v8
+* Changelog: [Github Repository Changelog](https://github.com/buanet/ioBroker.docker/blob/main/CHANGELOG.md)
+* Source code: [Github Repository](https://github.com/buanet/ioBroker.docker)
+* All other questions should be answered here: [ioBroker Docker image docs](https://docs.buanet.de/iobroker-docker-image/docs/) or [iobroker.net](https://www.iobroker.net/)
+
+# Supported tags
+
+It is highly recommended not to use the `latest` tag for production, especially when using any kind of automated update procedure like watchtower. Please use the `latest-v[major_version]` tag instead.
+
+### Node 18 versions
+* [`v9.1.2`](https://github.com/buanet/ioBroker.docker/blob/v9.1.2/debian12/Dockerfile), [`latest-v9`](https://github.com/buanet/ioBroker.docker/blob/v9.1.2/debian12/Dockerfile), [`latest`](https://github.com/buanet/ioBroker.docker/blob/v9.1.2/debian12/Dockerfile)
+* [`v9.1.1`](https://github.com/buanet/ioBroker.docker/blob/v9.1.1/debian12/Dockerfile)
+* [`v9.1.0`](https://github.com/buanet/ioBroker.docker/blob/v9.1.0/debian12/Dockerfile)
+* [`v9.0.1`](https://github.com/buanet/ioBroker.docker/blob/v9.0.1/debian12/Dockerfile)
+* [`v8.1.0`](https://github.com/buanet/ioBroker.docker/blob/v8.1.0/debian/node18/Dockerfile), [`latest-v8`](https://github.com/buanet/ioBroker.docker/blob/v8.1.0/debian/node18/Dockerfile), 
+* [`v8.0.1`](https://github.com/buanet/ioBroker.docker/blob/v8.0.1/debian/node18/Dockerfile)
+* [`v8.0.0`](https://github.com/buanet/ioBroker.docker/blob/v8.0.0/debian/node18/Dockerfile)
+
+### Node 16 versions
+* [`v7.2.0`](https://github.com/buanet/ioBroker.docker/blob/v7.2.0/debian/node16/Dockerfile), [`latest-v7`](https://github.com/buanet/ioBroker.docker/blob/v7.2.0/debian/node16/Dockerfile)
+* [`v7.1.2`](https://github.com/buanet/ioBroker.docker/blob/v7.1.2/debian/node16/Dockerfile), [`v7.1.2-amd64`](https://github.com/buanet/ioBroker.docker/blob/v7.1.2/debian/node16/Dockerfile), [`v7.1.2-arm32v7`](https://github.com/buanet/ioBroker.docker/blob/v7.1.2/debian/node16/Dockerfile), [`v7.1.2-arm64v8`](https://github.com/buanet/ioBroker.docker/blob/v7.1.2/debian/node16/Dockerfile)
+* [`v7.0.1`](https://github.com/buanet/ioBroker.docker/blob/v7.0.1/debian/node16/Dockerfile), [`v7.0.1-amd64`](https://github.com/buanet/ioBroker.docker/blob/v7.0.1/debian/node16/Dockerfile), [`v7.0.1-arm32v7`](https://github.com/buanet/ioBroker.docker/blob/v7.0.1/debian/node16/Dockerfile), [`v7.0.1-arm64v8`](https://github.com/buanet/ioBroker.docker/blob/v7.0.1/debian/node16/Dockerfile)
+
+# What is ioBroker?
+
+IoBroker is a open source IoT platform written in JavaScript that easily connects smarthome components from different manufactures. With the help of plugins (called: "adapters") ioBroker is able to communicate with a big variety of IoT hardware and services using different protocols and APIs.<br>
+All data is stored in a central database that all adapters can access. With this it is very easy to build up logical connections, automation scripts and beautiful visualizations.<br>
+For further details please check out [iobroker.net](https://www.iobroker.net).
+
+# How to use this image?
+
+## Running from command-line
+
+For taking a first look at iobroker on docker it would be enough to simply run the following basic docker run command:
+
+```
+docker run -p 8081:8081 --name iobroker -h iobroker buanet/iobroker
+```
+
+## Running with docker-compose
+
+When using docker-compose define the iobroker service like this:
+
+```
+version: '2'
+
+services:
+  iobroker:
+    container_name: iobroker
+    image: buanet/iobroker
+    hostname: iobroker
+    restart: always
+    ports:
+      - "8081:8081"
+```
+
+## Persistent data
+
+To make your ioBroker configuration persistent it is recommended to mount a volume or path to `/opt/iobroker`.
+
+On command-line add 
+```
+-v iobrokerdata:/opt/iobroker
+```
+On docker-compose add
+```
+    volumes:
+      - iobrokerdata:/opt/iobroker
+```
+
+## Configuration via environment variables
+
+You could use environment variables to auto configure your ioBroker container on startup. 
+
+### Configure ioBroker application:
+
+* `IOB_ADMINPORT` (optional, default: 8081) Set ioBroker adminport on startup
+* `IOB_BACKITUP_EXTDB` (optional) Set `true` for backing up external databases in ioBroker backitup adapter (Make sure your have read the [docs](https://docs.buanet.de/iobroker-docker-image/docs/#backup))
+* `IOB_MULTIHOST` (optional) Set "master" or "slave" for multihost support (needs additional config for objectsdb and statesdb!)
+* `IOB_OBJECTSDB_TYPE` (optional, default: jsonl) Set type of ioBroker objects db, could be "jsonl", "file" (deprecated) or "redis"
+* `IOB_OBJECTSDB_HOST` (optional, default: 127.0.0.1) Set host for ioBroker objects db, supports comma separated list for Redis Sentinel Cluster
+* `IOB_OBJECTSDB_PORT` (optional, default: 9001) Set port for ioBroker objects db, supports comma separated list for Redis Sentinel Cluster
+* `IOB_OBJECTSDB_PASS` (optional) Set authentication for Redis db connection
+* `IOB_OBJECTSDB_NAME` (optional, default: mymaster) Set name for Redis Sentinel CLuster db
+* `IOB_STATESDB_TYPE` (optional, default: jsonl) Set type of ioBroker states db, could be "jsonl", "file" (deprecated) or "redis"
+* `IOB_STATESDB_HOST` (optional, default: 127.0.0.1) Set host for ioBroker states db, supports comma separated list for Redis Sentinel Cluster
+* `IOB_STATESDB_PORT` (optional, default: 9000) Set port for ioBroker states db, supports comma separated list for Redis Sentinel Cluster
+* `IOB_STATESDB_PASS` (optional, default: 9000) Set authentication for Redis db connection
+* `IOB_STATESDB_NAME` (optional, default: mymaster) Set name for Redis Sentinel cluster db
+
+### Activate special features: 
+
+* `AVAHI` (optional) Set `true` to install and activate avahi-daemon for supporting yahka adapter
+
+### Configure environment:
+
+* `DEBUG` (optional) Set `true` to get extended logging messages on container startup
+* `LANG` (optional, default: de_DE.UTF-8) The following locales are pre-generated: de_DE.UTF-8, en_US.UTF-8
+* `LANGUAGE` (optional, default: de_DE:de) The following locales are pre-generated: de_DE:de, en_US:en
+* `LC_ALL` (optional, default: de_DE.UTF-8) The following locales are pre-generated: de_DE.UTF-8, en_US.UTF-8
+* `OFFLINE_MODE` (optional) Set `true` if your container has no or limited internet connection
+* `PACKAGES` (optional) Install additional Linux packages to your container, packages should be separated by whitespace like this: `package1 package2 package3`.
+* `PACKAGES_UPDATE` (optional) Set `true` if you want to apply Linux package updates at the first start of a new container.
+* `PERMISSION_CHECK` (optional, default: true) Set "false" to skip checking and correcting all relevant permissions on container startup (Use at own risk!!!)
+* `SETGID` (default: 1000) In some cases it might be useful to specify the gid of the containers iobroker user to match an existing group on the docker host
+* `SETUID` (default: 1000) In some cases it might be useful to specify the uid of the containers iobroker user to match an existing user on the docker host
+* `TZ` (optional, default: Europe/Berlin) Specifies the time zone, could be all valid Linux timezones
+* `USBDEVICES` (optional) Set relevant permissions on mounted devices like `/dev/ttyACM0` (inside the container), for more than one device separate with ";"
+
+## Notes about Docker networks
+
+The examples above are dealing with the Docker default bridge network. In general there are [some reasons](https://docs.docker.com/network/bridge/#differences-between-user-defined-bridges-and-the-default-bridge) why it might be the better choice to use a user-defined bridge network. 
+
+Using a Docker bridge network works fine for taking a first look and with most of the ioBroker adapters (if you don't forget to redirect the ports your adapters use).<br>
+But some ioBroker adapters are using techniques like [Multicast](https://en.wikipedia.org/wiki/Multicast) or [Broadcast](https://en.wikipedia.org/wiki/Broadcasting_(networking)) for automatic detection of IoT devices<br>
+In this case it may be useful to switch to [host](https://docs.docker.com/network/host/) or [MACVLAN](https://docs.docker.com/network/macvlan/) network. 
+
+For more information about networking with Docker please refer to the [official Docker docs](https://docs.docker.com/network/). 
+
+# Support the Project
+
+If you like what you see please leave us stars and likes on our repos and join our growing community.<br>
+See you soon. :)

docs/README_docker_hub_iobroker.md

@@ -0,0 +1,153 @@
+##### Note: The image provided as [iobroker/iobroker](https://hub.docker.com/r/iobroker/iobroker) is a mirror of [buanet/iobroker](https://hub.docker.com/r/buanet/iobroker) 
+ 
+<img src="https://github.com/buanet/ioBroker.docker/raw/main/docs/img/iobroker_logo.png" width="600" title="ioBroker Logo">
+
+[![Release](https://img.shields.io/github/v/release/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/releases)
+[![Pre-Release)](https://img.shields.io/github/v/tag/buanet/ioBroker.docker?include_prereleases&label=pre-release)](https://github.com/buanet/ioBroker.docker/releases)
+[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/buanet/ioBroker.docker/build-debian12-latest.yml?branch=main)](https://github.com/buanet/ioBroker.docker/actions/workflows/build-debian12-latest.yml)
+[![Github Issues](https://img.shields.io/github/issues/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/issues)
+[![Github Pull Requests](https://img.shields.io/github/issues-pr/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/pulls)
+[![GitHub Discussions](https://img.shields.io/github/discussions/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/discussions)<br>
+[![Arch](https://img.shields.io/badge/arch-amd64%20%7C%20arm32v7%20%7C%20arm64v8-blue)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Image Size (tag)](https://img.shields.io/docker/image-size/buanet/iobroker/latest?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Pulls](https://img.shields.io/docker/pulls/buanet/iobroker?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)
+[![Docker Stars](https://img.shields.io/docker/stars/buanet/iobroker?style=flat)](https://hub.docker.com/repository/docker/buanet/iobroker)<br>
+[![Source](https://img.shields.io/badge/source-github-blue?style=flat)](https://github.com/buanet/ioBroker.docker)
+[![GitHub forks](https://img.shields.io/github/forks/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/network)
+[![GitHub stars](https://img.shields.io/github/stars/buanet/ioBroker.docker)](https://github.com/buanet/ioBroker.docker/stargazers)
+[![License](https://img.shields.io/github/license/buanet/ioBroker.docker?style=flat)](https://github.com/buanet/ioBroker.docker/blob/master/LICENSE.md)
+[![Donate](https://img.shields.io/badge/donate-paypal-blue?style=flat)](https://paypal.me/buanet)
+
+# Important note
+
+New major image versions (e.g. v6, v7, v8) usually include a new major version of node! Although js-controller should handle this kind of upgrade fine, in some cases this still results in problems with some adapters. To avoid having trouble with this major version upgrades, it is always a good move to upgrade your container manually with backup and restore procedure. For more details please see the maintenance part of the [ioBroker Docker image docs](https://docs.buanet.de/iobroker-docker-image/docs/#maintenance).
+
+# Quick reference
+
+* Maintained by: [buanet](https://github.com/buanet) and [ioBroker](https://github.com/ioBroker)
+* Where to get support: [ioBroker forum](https://forum.iobroker.net/), [Discord channel](https://discord.gg/5jGWNKnpZ8), [Facebook group](https://www.facebook.com/groups/440499112958264)
+* Where to report issues: [Github Repository Issues](https://github.com/buanet/ioBroker.docker/issues)
+* Supported architectures: amd64, arm32v7, arm64v8
+* Changelog: [Github Repository Changelog](https://github.com/buanet/ioBroker.docker/blob/main/CHANGELOG.md)
+* Source code: [Github Repository](https://github.com/buanet/ioBroker.docker)
+* All other questions should be answered here: [ioBroker Docker image docs](https://docs.buanet.de/iobroker-docker-image/docs/) or [iobroker.net](https://www.iobroker.net/)
+
+# Supported tags
+
+It is highly recommended not to use the `latest` tag for production, especially when using any kind of automated update procedure like watchtower. Please use the `latest-v[major_version]` tag instead.
+
+### Node 18 versions
+* [`v9.1.2`](https://github.com/buanet/ioBroker.docker/blob/v9.1.2/debian12/Dockerfile), [`latest-v9`](https://github.com/buanet/ioBroker.docker/blob/v9.1.2/debian12/Dockerfile), [`latest`](https://github.com/buanet/ioBroker.docker/blob/v9.1.2/debian12/Dockerfile)
+* [`v9.1.1`](https://github.com/buanet/ioBroker.docker/blob/v9.1.1/debian12/Dockerfile)
+* [`v9.1.0`](https://github.com/buanet/ioBroker.docker/blob/v9.1.0/debian12/Dockerfile)
+* [`v9.0.1`](https://github.com/buanet/ioBroker.docker/blob/v9.0.1/debian12/Dockerfile)
+* [`v9.0.0`](https://github.com/buanet/ioBroker.docker/blob/v9.0.0/debian12/Dockerfile)
+* [`v8.1.0`](https://github.com/buanet/ioBroker.docker/blob/v8.1.0/debian/node18/Dockerfile), [`latest-v8`](https://github.com/buanet/ioBroker.docker/blob/v8.1.0/debian/node18/Dockerfile), 
+* [`v8.0.1`](https://github.com/buanet/ioBroker.docker/blob/v8.0.1/debian/node18/Dockerfile)
+* [`v8.0.0`](https://github.com/buanet/ioBroker.docker/blob/v8.0.0/debian/node18/Dockerfile)
+
+### Node 16 versions
+* [`v7.2.0`](https://github.com/buanet/ioBroker.docker/blob/v7.2.0/debian/node16/Dockerfile), [`latest-v7`](https://github.com/buanet/ioBroker.docker/blob/v7.2.0/debian/node16/Dockerfile)
+* [`v7.1.2`](https://github.com/buanet/ioBroker.docker/blob/v7.1.2/debian/node16/Dockerfile), [`v7.1.2-amd64`](https://github.com/buanet/ioBroker.docker/blob/v7.1.2/debian/node16/Dockerfile), [`v7.1.2-arm32v7`](https://github.com/buanet/ioBroker.docker/blob/v7.1.2/debian/node16/Dockerfile), [`v7.1.2-arm64v8`](https://github.com/buanet/ioBroker.docker/blob/v7.1.2/debian/node16/Dockerfile)
+* [`v7.0.1`](https://github.com/buanet/ioBroker.docker/blob/v7.0.1/debian/node16/Dockerfile), [`v7.0.1-amd64`](https://github.com/buanet/ioBroker.docker/blob/v7.0.1/debian/node16/Dockerfile), [`v7.0.1-arm32v7`](https://github.com/buanet/ioBroker.docker/blob/v7.0.1/debian/node16/Dockerfile), [`v7.0.1-arm64v8`](https://github.com/buanet/ioBroker.docker/blob/v7.0.1/debian/node16/Dockerfile)
+
+# What is ioBroker?
+
+IoBroker is a open source IoT platform written in JavaScript that easily connects smarthome components from different manufactures. With the help of plugins (called: "adapters") ioBroker is able to communicate with a big variety of IoT hardware and services using different protocols and APIs.<br>
+All data is stored in a central database that all adapters can access. With this it is very easy to build up logical connections, automation scripts and beautiful visualizations.<br>
+For further details please check out [iobroker.net](https://www.iobroker.net).
+
+# How to use this image?
+
+## Running from command-line
+
+For taking a first look at iobroker on docker it would be enough to simply run the following basic docker run command:
+
+```
+docker run -p 8081:8081 --name iobroker -h iobroker buanet/iobroker
+```
+
+## Running with docker-compose
+
+When using docker-compose define the iobroker service like this:
+
+```
+version: '2'
+
+services:
+  iobroker:
+    container_name: iobroker
+    image: buanet/iobroker
+    hostname: iobroker
+    restart: always
+    ports:
+      - "8081:8081"
+```
+
+## Persistent data
+
+To make your ioBroker configuration persistent it is recommended to mount a volume or path to `/opt/iobroker`.
+
+On command-line add 
+```
+-v iobrokerdata:/opt/iobroker
+```
+On docker-compose add
+```
+    volumes:
+      - iobrokerdata:/opt/iobroker
+```
+
+## Configuration via environment variables
+
+You could use environment variables to auto configure your ioBroker container on startup. 
+
+### Configure ioBroker application:
+
+* `IOB_ADMINPORT` (optional, default: 8081) Set ioBroker adminport on startup
+* `IOB_BACKITUP_EXTDB` (optional) Set `true` for backing up external databases in ioBroker backitup adapter (Make sure your have read the [docs](https://docs.buanet.de/iobroker-docker-image/docs/#backup))
+* `IOB_MULTIHOST` (optional) Set "master" or "slave" for multihost support (needs additional config for objectsdb and statesdb!)
+* `IOB_OBJECTSDB_TYPE` (optional, default: jsonl) Set type of ioBroker objects db, could be "jsonl", "file" (deprecated) or "redis"
+* `IOB_OBJECTSDB_HOST` (optional, default: 127.0.0.1) Set host for ioBroker objects db, supports comma separated list for Redis Sentinel Cluster
+* `IOB_OBJECTSDB_PORT` (optional, default: 9001) Set port for ioBroker objects db, supports comma separated list for Redis Sentinel Cluster
+* `IOB_OBJECTSDB_PASS` (optional) Set authentication for Redis db connection
+* `IOB_OBJECTSDB_NAME` (optional, default: mymaster) Set name for Redis Sentinel CLuster db
+* `IOB_STATESDB_TYPE` (optional, default: jsonl) Set type of ioBroker states db, could be "jsonl", "file" (deprecated) or "redis"
+* `IOB_STATESDB_HOST` (optional, default: 127.0.0.1) Set host for ioBroker states db, supports comma separated list for Redis Sentinel Cluster
+* `IOB_STATESDB_PORT` (optional, default: 9000) Set port for ioBroker states db, supports comma separated list for Redis Sentinel Cluster
+* `IOB_STATESDB_PASS` (optional, default: 9000) Set authentication for Redis db connection
+* `IOB_STATESDB_NAME` (optional, default: mymaster) Set name for Redis Sentinel cluster db
+
+### Activate special features: 
+
+* `AVAHI` (optional) Set `true` to install and activate avahi-daemon for supporting yahka adapter
+
+### Configure environment:
+
+* `DEBUG` (optional) Set `true` to get extended logging messages on container startup
+* `LANG` (optional, default: de_DE.UTF-8) The following locales are pre-generated: de_DE.UTF-8, en_US.UTF-8
+* `LANGUAGE` (optional, default: de_DE:de) The following locales are pre-generated: de_DE:de, en_US:en
+* `LC_ALL` (optional, default: de_DE.UTF-8) The following locales are pre-generated: de_DE.UTF-8, en_US.UTF-8
+* `OFFLINE_MODE` (optional) Set `true` if your container has no or limited internet connection
+* `PACKAGES` (optional) Install additional Linux packages to your container, packages should be separated by whitespace like this: `package1 package2 package3`.
+* `PACKAGES_UPDATE` (optional) Set `true` if you want to apply Linux package updates at the first start of a new container.
+* `PERMISSION_CHECK` (optional, default: true) Set "false" to skip checking and correcting all relevant permissions on container startup (Use at own risk!!!)
+* `SETGID` (default: 1000) In some cases it might be useful to specify the gid of the containers iobroker user to match an existing group on the docker host
+* `SETUID` (default: 1000) In some cases it might be useful to specify the uid of the containers iobroker user to match an existing user on the docker host
+* `TZ` (optional, default: Europe/Berlin) Specifies the time zone, could be all valid Linux timezones
+* `USBDEVICES` (optional) Set relevant permissions on mounted devices like `/dev/ttyACM0` (inside the container), for more than one device separate with ";"
+
+## Notes about Docker networks
+
+The examples above are dealing with the Docker default bridge network. In general there are [some reasons](https://docs.docker.com/network/bridge/#differences-between-user-defined-bridges-and-the-default-bridge) why it might be the better choice to use a user-defined bridge network. 
+
+Using a Docker bridge network works fine for taking a first look and with most of the ioBroker adapters (if you don't forget to redirect the ports your adapters use).<br>
+But some ioBroker adapters are using techniques like [Multicast](https://en.wikipedia.org/wiki/Multicast) or [Broadcast](https://en.wikipedia.org/wiki/Broadcasting_(networking)) for automatic detection of IoT devices<br>
+In this case it may be useful to switch to [host](https://docs.docker.com/network/host/) or [MACVLAN](https://docs.docker.com/network/macvlan/) network. 
+
+For more information about networking with Docker please refer to the [official Docker docs](https://docs.docker.com/network/). 
+
+# Support the Project
+
+If you like what you see please leave us stars and likes on our repos and join our growing community.
+See you soon. :)

scripts/startup.sh

@@ -1,9 +0,0 @@
-#!/bin/bash
-
-if [ -f .install_host ];
-then
-	sed -i "s/$(cat .install_host)/$(hostname)/g" iobroker-data/objects.json
-	rm .install_host
-fi
-
-node node_modules/iobroker.js-controller/controller.js