TimescaleDB is a PostgreSQL extension for time series and demanding workloads that ingest and query high volumes of data.
Want to skip these steps?
Deploy a Timescale service in the cloud. We tune your database for performance and handle scalability, high availability, backups and management so you can relax.
This section shows you how to:
- Install and configure TimescaleDB on PostgreSQL - set up a self-hosted PostgreSQL instance to efficiently run TimescaleDB.
- Add the TimescaleDB extension to your database - enable TimescaleDB features and performance improvements on a database.
Warning
If you have previously installed PostgreSQL without a package manager, you may encounter errors following these install instructions. Best practice is to full remove any existing PostgreSQL installations before you begin.
To keep your current PostgreSQL installation, Install from source.
To install TimescaleDB on your Windows device, you need:
This section shows you how to install the latest version of PostgreSQL and TimescaleDB on a supported platform using the packages supplied by Timescale.
Install the latest version of PostgreSQL and psql
Download PostgreSQL, then run the installer.
In the
Select Components
dialog, checkCommand Line Tools
, along with any other components you want to install, and clickNext
.Complete the installation wizard.
If you see an error like
could not load library "C:/Program Files/PostgreSQL/14/lib/timescaledb-2.16.1.dll": The specified module could not be found.
, use Dependencies to ensure that your system can find the compatible DLLs for this release of TimescaleDB.
Check that you can run
pg_config
. If you cannot runpg_config
from the command line, in the Windows Search tool, entersystem environment variables
. The path should beC:\Program Files\PostgreSQL\<version>\bin
.
Install TimescaleDB
Unzip the TimescaleDB installer to <install_dir>.
Best practice is to use the latest version.
In <install_dir>, right-click
setup.exe
, then chooseRun as Administrator
.Complete the installation wizard.
Tune your PostgreSQL instance for TimescaleDB
Run the
timescaledb-tune
script included in thetimescaledb-tools
package with TimescaleDB. For more information, see configuration.Login to PostgreSQL as
postgres
sudo -u postgres psqlYou are in the psql shell.
Set the password for
postgres
\password postgresWhen you have set the password, type
\q
to exit psql.
For improved performance, you enable TimescaleDB on each database on your self-hosted PostgreSQL instance.
This section shows you how to enable TimescaleDB for a new database in PostgreSQL using psql
from the command line.
Connect to a database on your PostgreSQL instance
In PostgreSQL, the default user and database are both
postgres
. To use a different database, set<database-name>
to the name of that database:psql -d "postgres://<username>:<password>@<host>:<port>/<database-name>"Add TimescaleDB to the database
CREATE EXTENSION IF NOT EXISTS timescaledb;Check that TimescaleDB is installed
\dxYou see the list of installed extensions:
List of installed extensionsName | Version | Schema | Description-------------+---------+------------+---------------------------------------------------------------------------------------plpgsql | 1.0 | pg_catalog | PL/pgSQL procedural languagetimescaledb | 2.15.1 | public | Enables scalable inserts and complex queries for time-series data (Community Edition)Press q to exit the list of extensions.
And that is it! You have TimescaleDB running on a database on a self-hosted instance of PostgreSQL.
Now you have TimescaleDB running, have a look at the:
- Tutorials: walk through a variety of business scenarios using example datasets.
- Use Timescale: browse the features available with TimescaleDB.
The latest TimescaleDB releases for PostgreSQL 13, 14, 15, and 16 are:
TimescaleDB is supported on the following platforms:
- Microsoft Windows 10
- Microsoft Windows 11
- Microsoft Windows Server 2019
For release information, see the [GitHub releases page][gh-releases] and the [release notes][release-notes].
Keywords
Found an issue on this page?Report an issue or Edit this page in GitHub.