thingsboard/msa/tb

ThingsBoard single docker images

This project provides the build for the ThingsBoard single docker images.

• thingsboard/tb - single instance of ThingsBoard with embedded HSQLDB database.
• thingsboard/tb-postgres - single instance of ThingsBoard with PostgreSQL database.
• thingsboard/tb-cassandra - single instance of ThingsBoard with Cassandra database.

Running

In this example thingsboard/tb image will be used. You can choose any other images with different databases (see above). Execute the following command to run this docker directly:

$ docker run -it -p 9090:9090 -p 1883:1883 -p 5683:5683/udp -v ~/.mytb-data:/data --name mytb thingsboard/tb

Where:

• docker run - run this container
• -it - attach a terminal session with current ThingsBoard process output
• -p 9090:9090 - connect local port 9090 to exposed internal HTTP port 9090
• -p 1883:1883 - connect local port 1883 to exposed internal MQTT port 1883
• -p 5683:5683 - connect local port 5683 to exposed internal COAP port 5683
• -v ~/.mytb-data:/data - mounts the host's dir ~/.mytb-data to ThingsBoard DataBase data directory
• --name mytb - friendly local name of this machine
• thingsboard/tb - docker image, can be also thingsboard/tb-postgres or thingsboard/tb-cassandra

Note

: Windows users should use docker managed volume instead of host's dir. Create docker volume (for ex. mytb-data) before executing docker run command:

$ docker create volume mytb-data

After you can execute docker run command using mytb-data volume instead of ~/.mytb-data. In order to get access to necessary resources from external IP/Host on Windows machine, please execute the following commands:

$ VBoxManage controlvm "default" natpf1 "tcp-port9090,tcp,,9090,,9090"  
$ VBoxManage controlvm "default" natpf1 "tcp-port1883,tcp,,1883,,1883"
$ VBoxManage controlvm "default" natpf1 "tcp-port5683,tcp,,5683,,5683"

After executing docker run command you can open http://{your-host-ip}:9090 in you browser (for ex. http://localhost:9090). You should see ThingsBoard login page. Use the following default credentials:

• System Administrator: sysadmin@thingsboard.org / sysadmin
• Tenant Administrator: tenant@thingsboard.org / tenant
• Customer User: customer@thingsboard.org / customer

You can always change passwords for each account in account profile page.

You can detach from session terminal with Ctrl-p Ctrl-q - the container will keep running in the background.

To reattach to the terminal (to see ThingsBoard logs) run:

$ docker attach mytb

To stop the container:

$ docker stop mytb

To start the container:

$ docker start mytb

Upgrading

In order to update to the latest image, execute the following commands:

$ docker pull thingsboard/tb
$ docker stop mytb
$ docker run -it -v ~/.mytb-data:/data --rm thingsboard/tb upgrade-tb.sh
$ docker start mytb

NOTE: if you use different database change image name in all commands from thingsboard/tb to thingsboard/tb-postgres or thingsboard/tb-cassandra correspondingly.

NOTE: replace host's directory ~/.mytb-data with directory used during container creation.