Install Promscale on Kubernetes

You can install Promscale on Kubernetes using Helm or using a manifest file.

Before installing Promscale, refer to:

Promscale Resource recommendation guide to understand the resource requirements.
Promscale Configuration recommendation guide to understand configuration requirements.

Before you begin

Install Helm. For more information, including packages and installation instructions, see the Helm documentation.
Create a TimescaleDB service on Timescale Cloud.

Promscale needs to access your TimescaleDB database. You can provide the database URI, or specify connection parameters.

Add the TimescaleDB Helm chart repository:

helm repo add timescale 'https://charts.timescale.com'

Check that the repository is up to date:
```
helm repo update
```
Install the Promscale Helm chart. Replace RELEASE_NAME with the name of your choice and TS_CLOUD_DB_URI with the Service URL that you made note of when you created the TimescaleDB service:
```
helm install <RELEASE_NAME> timescale/promscale --set connection.uri=<TS_CLOUD_DB_URI>
```

You can install the Promscale Connector using a manifest file.

curl https://raw.githubusercontent.com/timescale/promscale/0.14.0/deploy/static/deploy.yaml --output promscale-connector.yaml

Edit the manifest and configure the TimescaleDB database details. Add the <PROMSCALE_DB_URI> parameter in promscale secret, and remove the other <PROMSCALE_DB_*> parameters. These are not required, because Promscale Connector integrates with Timescale Cloud directly.

Deploy the manifest:

kubectl apply -f promscale-connector.yaml

When you have installed Promscale, you can ingest data in a few different ways: