https://github.com/andreiramani/timescaledb_pgsql_windows
TimescaleDB - Time-series database for real-time analytics as a Postgres extension (Repackage for Microsoft Windows)
https://github.com/andreiramani/timescaledb_pgsql_windows
database devops financial-analytics iot microsoft microsoft-windows microsoft-windows-11 pgsql plsql postgresql real-time-analytics tigerdata time-series time-series-analysis timescaledb timeseries-database tsdb
Last synced: 1 day ago
JSON representation
TimescaleDB - Time-series database for real-time analytics as a Postgres extension (Repackage for Microsoft Windows)
- Host: GitHub
- URL: https://github.com/andreiramani/timescaledb_pgsql_windows
- Owner: andreiramani
- License: apache-2.0
- Created: 2026-05-30T16:11:56.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-31T03:54:32.000Z (about 1 month ago)
- Last Synced: 2026-06-13T07:08:17.153Z (30 days ago)
- Topics: database, devops, financial-analytics, iot, microsoft, microsoft-windows, microsoft-windows-11, pgsql, plsql, postgresql, real-time-analytics, tigerdata, time-series, time-series-analysis, timescaledb, timeseries-database, tsdb
- Homepage:
- Size: 55.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [**TimescaleDB**](https://github.com/timescale/timescaledb) RE-package
## **TimescaleDB - Time-series database for high-performance real-time analytics packaged as a Postgres extension**
---
## Notes and Installation Guide
I needed **TimescaleDB** for one of my projects while running **Windows 11 (25H2)** with **PostgreSQL v16.1**. Although [Tiger Data](https://www.tigerdata.com/docs/get-started/choose-your-path/install-timescaledb) provides various installation instructions (including Windows), unfortunately the installer could not locate my `pg_config`.
### What I tried
- I attempted to **compile TimescaleDB from the latest source**, but the latest source no longer supports my PostgreSQL version. The build failed with the following error:
```
\timescaledb\src\compat\compat.h(63,1): error C1189: #error: "Unsupported PostgreSQL version" [\timescaledb\build\tsl\src\timescaledb-tsl.vcxproj]
```
From this error it is clear that the correct TimescaleDB version for a given PostgreSQL release can be determined by inspecting `src/compat/compat.h` in the TimescaleDB [source](https://github.com/timescale/timescaledb) branches.
### How I resolved it
1. I reviewed the TimescaleDB release packages on GitHub and tested several older releases until I found a package compatible with PostgreSQL v16.1.
2. Once I found a matching release package, I installed the extension using the steps below.
### Installing the TimescaleDB extension on Windows (binary package)
1. Stop the PostgreSQL service via `services.msc`.
2. Download the appropriate TimescaleDB package from the [Releases](https://github.com/andreiramani/timescaledb-windows/releases) page (choose the package that matches your PostgreSQL version).
3. Extract the ZIP file into your PostgreSQL installation directory (overwrite or merge files as required).
a. `*.dll` files goes to `\lib` folder
b. `*.control` and `*.sql` files goes to `\share\extension` folder.
c. `timescaledb-tune.exe` goes to `\bin` folder.
4. From `\bin` run `timescaledb-tune.exe -conf-path \data -pg-version ` to optimize `postgresql.conf` settings.
(`postgresql.conf` location is in `\data`)
5. Start the PostgreSQL service.
6. Connect to PostgreSQL, from destination DB run:
```
CREATE EXTENSION IF NOT EXISTS timescaledb;
```
7. If the command returns `OK`, the TimescaleDB extension is installed successfully.
8. Verify version: `SELECT extname, extversion FROM pg_extension WHERE extname = 'timescaledb';`
### Troubleshooting
- Choose the correct package: Always download the TimescaleDB package that exactly matches your PostgreSQL version and architecture.
- Common error after CREATE EXTENSION:
```
ERROR: could not load library "/lib/timescaledb-x.xx.x.dll": The specified procedure could not be found.
```
This error indicates the TimescaleDB binary is incompatible with the running PostgreSQL version. The fix is to downgrade or switch to a TimescaleDB release that matches your PostgreSQL version.
### Technical note
- If you attempt to build from the latest source and encounter the Unsupported PostgreSQL version error, inspect `src/compat/compat.h` in the TimescaleDB source to see which PostgreSQL versions are supported by that TimescaleDB commit/release.
### Limitation
- Currently, I have not tested all available TimescaleDB packages. Only the version that I use for my project will be included in the releases.
### Request / Call for help
If you have a TimescaleDB binary package that is compatible with other PostgreSQL versions on Windows, please let me know/drop info on [`Discussion`](https://github.com/andreiramani/timescaledb-windows/discussions). I am especially interested in packages for PostgreSQL versions commonly used on Windows machines.
### Summary
The official Windows instructions may fail for some local setups. When building from source, check `src/compat/compat.h` for supported PostgreSQL versions. For most users on Windows, the quickest path is to find a prebuilt TimescaleDB release that matches your PostgreSQL version.
***
[](https://www.star-history.com/?repos=andreiramani%2Ftimescaledb_pgsql_windows&type=timeline&legend=top-left)