ThingsBoard Postgres

ThingsBoard Postgres is a Dockerized deployment of the open-source ThingsBoard IoT platform with PostgreSQL for self-hosting IoT data collection, processing,…

  • Home Automation
  • Monitoring & Logging
  • Network Services
  • Tools & Utilities
ThingsBoard Postgres is a Dockerized deployment of the open-source ThingsBoard IoT platform with PostgreSQL for self-hosting IoT data collection, processing, visualization, and device management.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

81/100 Excellent

Maintained
100last commit 15 days ago
Popular
8722,659 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
801 GB minimum RAM, runs on ARM

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
22,659
Open issues
392
Last commit
2026-11-06
Latest release
v4.4.0.2
Activity
steady

Checked 12 days ago - source: GitHub (thingsboard/thingsboard)

Resources & Compatibility

Minimum requirements: 1 GB RAM. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install PostgreSQL 16 and initialize it On CentOS, disable the older PostgreSQL module first, install PostgreSQL 16, the database ThingsBoard uses, and run initdb to create the empty database files; without the right version and initialized database, ThingsBoard can't save data. source
  • Make PostgreSQL start after reboot Enable the postgresql-16 service (the background program that keeps the database running) so the database comes back automatically after a reboot; otherwise ThingsBoard may work at first but fail after the machine restarts. source
  • Install PostgreSQL 16 on Ubuntu On Ubuntu, add the PostgreSQL repository (where Ubuntu downloads PostgreSQL from), install PostgreSQL 16, and start the service so the database is ready before installing ThingsBoard; if the database isn't running, ThingsBoard can't save or load its data. source
  • Unraid first run Run the container once to create directories, stop it, run chown -R 799:799 /mnt/user/appdata/thingsboard-postgres in the Unraid terminal, then start it again. source

Fetched 37 days ago - each note links to its source

Alternatives (3)

  • Cloud Studio IoT - White-label, multi-tenant IoT/IIoT Application Enablement Platform (AEP) for integrators, device makers and service operators.
  • Iotellect - A powerful low-code IoT Application Enablement Platform (AEP) that seamlessly integrates Edge and Cloud capabilities for scalable, real-tim…
  • thingsboard - ThingsBoard is an open-source internet of things platform for collecting, processing and visualising data, and managing devices.

Checked 40 days ago - source: AlternativeTo

Common questions

Does the thingsboard/tb-postgres container include a psql client?

Only what was installed by the image maintainer is available inside the container, so a psql client is not guaranteed.

Can ThingsBoard be pointed at an external RDS PostgreSQL instead of the local tb-postgres container?

Yes, the tb-postgres image is normally local, but connection parameters in your .yml or .env files can point to RDS. Verify the host can reach RDS.

How can I make the PostgreSQL database start automatically after reboot during a ThingsBoard edge install?

Enable the postgresql-16 service on CentOS. If it is not enabled, ThingsBoard may work at first but fail after the machine restarts.

Does the ThingsBoard troubleshooting documentation cover OAuth2 configuration?

Yes, OAuth2 configuration is listed among common issues to diagnose and resolve.

Answers sourced from forums.docker.com, github.com, github.com, thingsboard.io

Community

Collected 48 days ago - public community threads