Upgrades within a Docker container

note

In this section, the examples use a Docker instance called . If you have given your Docker instance a different name, replace it when you issue the commands.

When you start your upgraded Docker container, you need to be able to point the new Docker image to the location that contains the data from your previous version. To do this, you need to work out where the current mount point is. The current mount point varies depending on whether your container is using volume mounts, or bind mounts.

  1. Work out what type of mount your Docker container uses by running this command, which returns either volume or bind:

Upgrade TimescaleDB within Docker

To upgrade TimescaleDB within Docker, you need to download the upgraded image, stop the old container, and launch the new container pointing to your existing data.

Upgrading TimescaleDB within Docker

  1. Pull the latest TimescaleDB image. This command pulls the image for PostgreSQL 14. If you’re using another PostgreSQL version, look for the relevant tag in the .

  2. Stop the old container, and remove it:

  3. Connect to the upgraded instance using psql with the -X flag:

  4. At the psql prompt, use the ALTER command to upgrade the extension:

    1. CREATE EXTENSION IF NOT EXISTS timescaledb_toolkit;
    2. ALTER EXTENSION timescaledb_toolkit UPDATE;
note

If you have multiple databases, you need to update each database separately.