Promscale has been discontinued. We strongly recommend that you do not use Promscale in a production environment. Learn more.
You can install Promscale from a pre-complied binary on any operating systems. The Promscale binary file is available at GitHub releases page.
Before you begin, you must have an already installed and working Prometheus or OpenTelemetry collector environment.
To use Promscale, you need a TimescaleDB database, as well as the Promscale extension. The Promscale extension contains support functions to improve performance of Promscale.
Download the Promscale binary file and run the file.
At the command prompt, as a root user, download the appropriate file for your operating system (get the URL from the GitHub repository releases page):curl -L -o promscale https://github.com/timescale/promscale/releases/download/<VERSION>/<PROMSCALE_DISTRIBUTION>
Grant executable permissions to the
promscaledirectory:chmod +x promscale
Run Promscale by providing the connection details for your TimescaleDB service:./promscale --db-host <DB_HOSTNAME> --db-port <DB_PORT> --db-name <DBNAME> --db-password <DBPASSWORD> --db-ssl-mode allow
In this example, Promscale is deployed with SSL allowed but not required. If you need SSL mode enabled, configure your TimescaleDB instance with SSL certificates and do not use
--db-ssl-modeflag. Promscale authenticates using SSL by default.