ThingsBoard

ThingsBoard is an open-source IoT platform for device management, data collection, processing, visualization, and automation.

Configuration

version: "3.8"

services:
  thingsboard:
    image: thingsboard/tb-node:4.3.1.1
    restart: unless-stopped
    depends_on:
      thingsboard-db:
        condition: service_healthy
      thingsboard-init:
        condition: service_completed_successfully
    expose:
      - "8080"
    environment:
      TB_SERVICE_ID: tb-ce-node
      TB_QUEUE_TYPE: in-memory
      JAVA_OPTS: ${JAVA_OPTS}
      SPRING_DATASOURCE_URL: jdbc:postgresql://thingsboard-db:5432/${POSTGRES_DB}
      SPRING_DATASOURCE_USERNAME: ${POSTGRES_USER}
      SPRING_DATASOURCE_PASSWORD: ${POSTGRES_PASSWORD}
      SECURITY_CORS_ALLOWED_ORIGINS: ${SECURITY_CORS_ALLOWED_ORIGINS}
    volumes:
      - thingsboard-logs:/var/log/thingsboard
    healthcheck:
      test: ["CMD-SHELL", "timeout 5 bash -c '</dev/tcp/127.0.0.1/8080'"]
      interval: 30s
      timeout: 10s
      retries: 10
      start_period: 300s

  thingsboard-init:
    image: thingsboard/tb-node:4.3.1.1
    restart: on-failure
    # The image runs as the non-root "thingsboard" user, which cannot write
    # the install marker to the freshly created (root-owned) /data volume.
    user: root
    depends_on:
      thingsboard-db:
        condition: service_healthy
    command:
      - bash
      - -c
      - |
        set -e
        if [ -f /data/.thingsboard-installed ]; then
          echo "ThingsBoard database already initialized."
          exit 0
        fi
        INSTALL_TB=true LOAD_DEMO=$${LOAD_DEMO:-false} start-tb-node.sh
        touch /data/.thingsboard-installed
    environment:
      TB_SERVICE_ID: tb-ce-node
      TB_QUEUE_TYPE: in-memory
      JAVA_OPTS: ${JAVA_OPTS}
      LOAD_DEMO: ${LOAD_DEMO}
      SPRING_DATASOURCE_URL: jdbc:postgresql://thingsboard-db:5432/${POSTGRES_DB}
      SPRING_DATASOURCE_USERNAME: ${POSTGRES_USER}
      SPRING_DATASOURCE_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - thingsboard-install:/data
      - thingsboard-logs:/var/log/thingsboard

  thingsboard-db:
    image: postgres:18
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - thingsboard-db:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 10s

volumes:
  thingsboard-db:
  thingsboard-install:
  thingsboard-logs:

[variables]
main_domain = "${domain}"
postgres_password = "${password:32}"
load_demo = "false"
java_opts = "-Xms512m -Xmx2048m"

[[config.domains]]
serviceName = "thingsboard"
port = 8080
host = "${main_domain}"
path = "/"

[[config.mounts]]
filePath = "README.md"
content = """# ThingsBoard

This template deploys ThingsBoard Community Edition with PostgreSQL using the official `thingsboard/tb-node` Docker image.

## First start

The `thingsboard-init` service initializes the database once before the main service starts. By default it performs a clean install. Set `load_demo` to `true` before deploying if you want ThingsBoard's sample tenant, dashboards, and demo devices.

## Login

Open `https://${main_domain}` and sign in with the default system administrator account:

- Email: `[email protected]`
- Password: `sysadmin`

Change the default password before exposing the instance to production users.

## Device connectivity

The web UI and HTTP device API are available through the configured domain. MQTT, CoAP, and additional transport ports are not publicly exposed by this template; expose them separately in Dokploy if your deployment requires direct device connections over those protocols.
"""

[config.env]
POSTGRES_DB = "thingsboard"
POSTGRES_USER = "postgres"
POSTGRES_PASSWORD = "${postgres_password}"
LOAD_DEMO = "${load_demo}"
JAVA_OPTS = "${java_opts}"
SECURITY_CORS_ALLOWED_ORIGINS = "http://${main_domain},https://${main_domain}"

Base64

To import this template in Dokploy: create a Compose service → Advanced → Base64 import and paste the content below:

ewogICJjb21wb3NlIjogInZlcnNpb246IFwiMy44XCJcblxuc2VydmljZXM6XG4gIHRoaW5nc2JvYXJkOlxuICAgIGltYWdlOiB0aGluZ3Nib2FyZC90Yi1ub2RlOjQuMy4xLjFcbiAgICByZXN0YXJ0OiB1bmxlc3Mtc3RvcHBlZFxuICAgIGRlcGVuZHNfb246XG4gICAgICB0aGluZ3Nib2FyZC1kYjpcbiAgICAgICAgY29uZGl0aW9uOiBzZXJ2aWNlX2hlYWx0aHlcbiAgICAgIHRoaW5nc2JvYXJkLWluaXQ6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9jb21wbGV0ZWRfc3VjY2Vzc2Z1bGx5XG4gICAgZXhwb3NlOlxuICAgICAgLSBcIjgwODBcIlxuICAgIGVudmlyb25tZW50OlxuICAgICAgVEJfU0VSVklDRV9JRDogdGItY2Utbm9kZVxuICAgICAgVEJfUVVFVUVfVFlQRTogaW4tbWVtb3J5XG4gICAgICBKQVZBX09QVFM6ICR7SkFWQV9PUFRTfVxuICAgICAgU1BSSU5HX0RBVEFTT1VSQ0VfVVJMOiBqZGJjOnBvc3RncmVzcWw6Ly90aGluZ3Nib2FyZC1kYjo1NDMyLyR7UE9TVEdSRVNfREJ9XG4gICAgICBTUFJJTkdfREFUQVNPVVJDRV9VU0VSTkFNRTogJHtQT1NUR1JFU19VU0VSfVxuICAgICAgU1BSSU5HX0RBVEFTT1VSQ0VfUEFTU1dPUkQ6ICR7UE9TVEdSRVNfUEFTU1dPUkR9XG4gICAgICBTRUNVUklUWV9DT1JTX0FMTE9XRURfT1JJR0lOUzogJHtTRUNVUklUWV9DT1JTX0FMTE9XRURfT1JJR0lOU31cbiAgICB2b2x1bWVzOlxuICAgICAgLSB0aGluZ3Nib2FyZC1sb2dzOi92YXIvbG9nL3RoaW5nc2JvYXJkXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OiBbXCJDTUQtU0hFTExcIiwgXCJ0aW1lb3V0IDUgYmFzaCAtYyAnPC9kZXYvdGNwLzEyNy4wLjAuMS84MDgwJ1wiXVxuICAgICAgaW50ZXJ2YWw6IDMwc1xuICAgICAgdGltZW91dDogMTBzXG4gICAgICByZXRyaWVzOiAxMFxuICAgICAgc3RhcnRfcGVyaW9kOiAzMDBzXG5cbiAgdGhpbmdzYm9hcmQtaW5pdDpcbiAgICBpbWFnZTogdGhpbmdzYm9hcmQvdGItbm9kZTo0LjMuMS4xXG4gICAgcmVzdGFydDogb24tZmFpbHVyZVxuICAgICMgVGhlIGltYWdlIHJ1bnMgYXMgdGhlIG5vbi1yb290IFwidGhpbmdzYm9hcmRcIiB1c2VyLCB3aGljaCBjYW5ub3Qgd3JpdGVcbiAgICAjIHRoZSBpbnN0YWxsIG1hcmtlciB0byB0aGUgZnJlc2hseSBjcmVhdGVkIChyb290LW93bmVkKSAvZGF0YSB2b2x1bWUuXG4gICAgdXNlcjogcm9vdFxuICAgIGRlcGVuZHNfb246XG4gICAgICB0aGluZ3Nib2FyZC1kYjpcbiAgICAgICAgY29uZGl0aW9uOiBzZXJ2aWNlX2hlYWx0aHlcbiAgICBjb21tYW5kOlxuICAgICAgLSBiYXNoXG4gICAgICAtIC1jXG4gICAgICAtIHxcbiAgICAgICAgc2V0IC1lXG4gICAgICAgIGlmIFsgLWYgL2RhdGEvLnRoaW5nc2JvYXJkLWluc3RhbGxlZCBdOyB0aGVuXG4gICAgICAgICAgZWNobyBcIlRoaW5nc0JvYXJkIGRhdGFiYXNlIGFscmVhZHkgaW5pdGlhbGl6ZWQuXCJcbiAgICAgICAgICBleGl0IDBcbiAgICAgICAgZmlcbiAgICAgICAgSU5TVEFMTF9UQj10cnVlIExPQURfREVNTz0kJHtMT0FEX0RFTU86LWZhbHNlfSBzdGFydC10Yi1ub2RlLnNoXG4gICAgICAgIHRvdWNoIC9kYXRhLy50aGluZ3Nib2FyZC1pbnN0YWxsZWRcbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIFRCX1NFUlZJQ0VfSUQ6IHRiLWNlLW5vZGVcbiAgICAgIFRCX1FVRVVFX1RZUEU6IGluLW1lbW9yeVxuICAgICAgSkFWQV9PUFRTOiAke0pBVkFfT1BUU31cbiAgICAgIExPQURfREVNTzogJHtMT0FEX0RFTU99XG4gICAgICBTUFJJTkdfREFUQVNPVVJDRV9VUkw6IGpkYmM6cG9zdGdyZXNxbDovL3RoaW5nc2JvYXJkLWRiOjU0MzIvJHtQT1NUR1JFU19EQn1cbiAgICAgIFNQUklOR19EQVRBU09VUkNFX1VTRVJOQU1FOiAke1BPU1RHUkVTX1VTRVJ9XG4gICAgICBTUFJJTkdfREFUQVNPVVJDRV9QQVNTV09SRDogJHtQT1NUR1JFU19QQVNTV09SRH1cbiAgICB2b2x1bWVzOlxuICAgICAgLSB0aGluZ3Nib2FyZC1pbnN0YWxsOi9kYXRhXG4gICAgICAtIHRoaW5nc2JvYXJkLWxvZ3M6L3Zhci9sb2cvdGhpbmdzYm9hcmRcblxuICB0aGluZ3Nib2FyZC1kYjpcbiAgICBpbWFnZTogcG9zdGdyZXM6MThcbiAgICByZXN0YXJ0OiB1bmxlc3Mtc3RvcHBlZFxuICAgIGVudmlyb25tZW50OlxuICAgICAgUE9TVEdSRVNfREI6ICR7UE9TVEdSRVNfREJ9XG4gICAgICBQT1NUR1JFU19VU0VSOiAke1BPU1RHUkVTX1VTRVJ9XG4gICAgICBQT1NUR1JFU19QQVNTV09SRDogJHtQT1NUR1JFU19QQVNTV09SRH1cbiAgICB2b2x1bWVzOlxuICAgICAgLSB0aGluZ3Nib2FyZC1kYjovdmFyL2xpYi9wb3N0Z3Jlc3FsXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OiBbXCJDTUQtU0hFTExcIiwgXCJwZ19pc3JlYWR5IC1VICQke1BPU1RHUkVTX1VTRVJ9IC1kICQke1BPU1RHUkVTX0RCfVwiXVxuICAgICAgaW50ZXJ2YWw6IDEwc1xuICAgICAgdGltZW91dDogNXNcbiAgICAgIHJldHJpZXM6IDVcbiAgICAgIHN0YXJ0X3BlcmlvZDogMTBzXG5cbnZvbHVtZXM6XG4gIHRoaW5nc2JvYXJkLWRiOlxuICB0aGluZ3Nib2FyZC1pbnN0YWxsOlxuICB0aGluZ3Nib2FyZC1sb2dzOlxuIiwKICAiY29uZmlnIjogIlt2YXJpYWJsZXNdXG5tYWluX2RvbWFpbiA9IFwiJHtkb21haW59XCJcbnBvc3RncmVzX3Bhc3N3b3JkID0gXCIke3Bhc3N3b3JkOjMyfVwiXG5sb2FkX2RlbW8gPSBcImZhbHNlXCJcbmphdmFfb3B0cyA9IFwiLVhtczUxMm0gLVhteDIwNDhtXCJcblxuW1tjb25maWcuZG9tYWluc11dXG5zZXJ2aWNlTmFtZSA9IFwidGhpbmdzYm9hcmRcIlxucG9ydCA9IDgwODBcbmhvc3QgPSBcIiR7bWFpbl9kb21haW59XCJcbnBhdGggPSBcIi9cIlxuXG5bW2NvbmZpZy5tb3VudHNdXVxuZmlsZVBhdGggPSBcIlJFQURNRS5tZFwiXG5jb250ZW50ID0gXCJcIlwiIyBUaGluZ3NCb2FyZFxuXG5UaGlzIHRlbXBsYXRlIGRlcGxveXMgVGhpbmdzQm9hcmQgQ29tbXVuaXR5IEVkaXRpb24gd2l0aCBQb3N0Z3JlU1FMIHVzaW5nIHRoZSBvZmZpY2lhbCBgdGhpbmdzYm9hcmQvdGItbm9kZWAgRG9ja2VyIGltYWdlLlxuXG4jIyBGaXJzdCBzdGFydFxuXG5UaGUgYHRoaW5nc2JvYXJkLWluaXRgIHNlcnZpY2UgaW5pdGlhbGl6ZXMgdGhlIGRhdGFiYXNlIG9uY2UgYmVmb3JlIHRoZSBtYWluIHNlcnZpY2Ugc3RhcnRzLiBCeSBkZWZhdWx0IGl0IHBlcmZvcm1zIGEgY2xlYW4gaW5zdGFsbC4gU2V0IGBsb2FkX2RlbW9gIHRvIGB0cnVlYCBiZWZvcmUgZGVwbG95aW5nIGlmIHlvdSB3YW50IFRoaW5nc0JvYXJkJ3Mgc2FtcGxlIHRlbmFudCwgZGFzaGJvYXJkcywgYW5kIGRlbW8gZGV2aWNlcy5cblxuIyMgTG9naW5cblxuT3BlbiBgaHR0cHM6Ly8ke21haW5fZG9tYWlufWAgYW5kIHNpZ24gaW4gd2l0aCB0aGUgZGVmYXVsdCBzeXN0ZW0gYWRtaW5pc3RyYXRvciBhY2NvdW50OlxuXG4tIEVtYWlsOiBgc3lzYWRtaW5AdGhpbmdzYm9hcmQub3JnYFxuLSBQYXNzd29yZDogYHN5c2FkbWluYFxuXG5DaGFuZ2UgdGhlIGRlZmF1bHQgcGFzc3dvcmQgYmVmb3JlIGV4cG9zaW5nIHRoZSBpbnN0YW5jZSB0byBwcm9kdWN0aW9uIHVzZXJzLlxuXG4jIyBEZXZpY2UgY29ubmVjdGl2aXR5XG5cblRoZSB3ZWIgVUkgYW5kIEhUVFAgZGV2aWNlIEFQSSBhcmUgYXZhaWxhYmxlIHRocm91Z2ggdGhlIGNvbmZpZ3VyZWQgZG9tYWluLiBNUVRULCBDb0FQLCBhbmQgYWRkaXRpb25hbCB0cmFuc3BvcnQgcG9ydHMgYXJlIG5vdCBwdWJsaWNseSBleHBvc2VkIGJ5IHRoaXMgdGVtcGxhdGU7IGV4cG9zZSB0aGVtIHNlcGFyYXRlbHkgaW4gRG9rcGxveSBpZiB5b3VyIGRlcGxveW1lbnQgcmVxdWlyZXMgZGlyZWN0IGRldmljZSBjb25uZWN0aW9ucyBvdmVyIHRob3NlIHByb3RvY29scy5cblwiXCJcIlxuXG5bY29uZmlnLmVudl1cblBPU1RHUkVTX0RCID0gXCJ0aGluZ3Nib2FyZFwiXG5QT1NUR1JFU19VU0VSID0gXCJwb3N0Z3Jlc1wiXG5QT1NUR1JFU19QQVNTV09SRCA9IFwiJHtwb3N0Z3Jlc19wYXNzd29yZH1cIlxuTE9BRF9ERU1PID0gXCIke2xvYWRfZGVtb31cIlxuSkFWQV9PUFRTID0gXCIke2phdmFfb3B0c31cIlxuU0VDVVJJVFlfQ09SU19BTExPV0VEX09SSUdJTlMgPSBcImh0dHA6Ly8ke21haW5fZG9tYWlufSxodHRwczovLyR7bWFpbl9kb21haW59XCJcbiIKfQ==

Configuration

Base64

Links

Tags

On this page