Install and configure TimescaleDB on Postgres
This section shows you how to install the latest version of Postgres and TimescaleDB on a supported platform using containers supplied by Tiger Data.
- Run the TimescaleDB Docker image
The TimescaleDB HA Docker image offers the most complete TimescaleDB experience. It uses [Ubuntu][ubuntu], includes TimescaleDB Toolkit, and support for PostGIS and Patroni.
To install the latest release based on Postgres 17:
TimescaleDB is pre-created in the default Postgres database and is added by default to any new database you create in this image.
- Run the container
Replace </a/local/data/folder> with the path to the folder you want to keep your data in the following command.
If you are running multiple container instances, change the port each Docker instance runs on.
On UNIX-based systems, Docker modifies Linux IP tables to bind the container. If your system uses Linux Uncomplicated Firewall (UFW), Docker may [override your UFW port binding settings][override-binding]. To prevent this, add DOCKER_OPTS="--iptables=false" to /etc/default/docker.
- Connect to a database on your Postgres instance
The default user and database are both postgres. You set the password in POSTGRES_PASSWORD in the previous step. The default command to connect to Postgres is:
- Check that TimescaleDB is installed
You see the list of installed extensions:
Press q to exit the list of extensions.