timescaledb-docker

by timescale

Release Docker builds of TimescaleDB

146 Stars 80 Forks Last release: Not found Apache License 2.0 103 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Timescale

What is TimescaleDB?

TimescaleDB is an open-source database designed to make SQL scalable for time-series data. For more information, see the Timescale website.

How to use this image

This image is based on the official Postgres docker image so the documentation for that image also applies here, including the environment variables one can set, extensibility, etc.

Starting a TimescaleDB instance

$ docker run -d --name some-timescaledb -p 5432:5432 timescale/timescaledb

Then connect with an app or the

psql
client:
$ docker run -it --net=host --rm timescale/timescaledb psql -h localhost -U postgres

You can also connect your app via port

5432
on the host machine.

If you are running your docker image for the first time, you can also set an environmental variable,

TIMESCALEDB_TELEMETRY
, to set the level of telemetry in the Timescale docker instance. For example, to turn off telemetry, run:
$ docker run -d --name some-timescaledb -p 5432:5432 --env TIMESCALEDB_TELEMETRY=off timescale/timescaledb

Note that if the cluster has previously been initialized, you should not use this environment variable to set the level of telemetry. Instead, follow the instructions in our docs to disable telemetry once a cluster is running.

Notes on timescaledb-tune

We run

timescaledb-tune
automatically on container initialization. By default,
timescaledb-tune
uses system calls to retrieve an instance's available CPU and memory. In docker images, these system calls reflect the available resources on the host. For cases where a container is allocated all available resources on a host, this is fine. But many use cases involve limiting the amount of resources a container (or the docker daemon) can have on the host. Therefore, this image looks in the cgroups metadata to determine the docker-defined limit sizes then passes those values to
timescaledb-tune
.

To specify your own limits, use the

TS_TUNE_MEMORY
and
TS_TUNE_NUM_CPUS
environment variables at runtime:
$ docker run -d --name timescaledb -p 5432:5432 -e POSTGRES_PASSWORD=password -e TS_TUNE_MEMORY=4GB -e TS_TUNE_NUM_CPUS=4 timescale/timescaledb:latest-pg11

To not run

timescaledb-tune
at all, use the
NO_TS_TUNE
environment variable:
$ docker run -d --name timescaledb -p 5432:5432 -e POSTGRES_PASSWORD=password -e NO_TS_TUNE=true timescale/timescaledb:latest-pg11

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.