thingsboard/msa/tb/README.md

69 lines
2.2 KiB
Markdown
Raw Normal View History

# 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
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
After executing this command you can open `http://{yor-host-ip}:9090` in you browser. You should see ThingsBoard login page.
Use the following default credentials:
- **Systen 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**: replace host's directory `~/.mytb-data` with directory used during container creation.