This image is designed to supercede the legacy CircleCI PostgreSQL image, circleci/postgres
.
cimg/postgres
is a Docker image created by CircleCI with continuous integration builds in mind.
This image can be used with the CircleCI docker
executor as a secondary image.
For example:
1
2
3
4
5
6
7
jobs:
build:
docker:
- image: cimg/go:1.17
- image: cimg/postgres:17.2.0
steps:
- checkout
In the above example, the CircleCI Go Docker image is used for the primary container while the PostgreSQL image is used as a secondary.
More specifically, the tag 13.2
is used meaning the version of PostgreSQL will be v13.2.
You can now connect to a PostgreSQL instance from the primary image within the steps for this job.
This image contains the PostgreSQL database and its complete toolchain.
This image has the following tagging scheme:
cimg/postgres:<pg-version>[-variant]
<pg-version>
- The version of PostgreSQL to use.
[-variant]
- a variant tag can optionally be added.
The available variants can be found below.
TAG | ALIAS | INSTALLED SOFTWARE | SIZE | LAST MODIFIED |
---|---|---|---|---|
2025.02 | current-22.04current2025.02-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.48.1, jq 1.6, ubuntu 22.04.5 LTS, wget 1.21.2 Show more | 0.00 B | Feb 1, 2025 |
2025.02-20.04 | current-20.04 | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.48.1, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Feb 1, 2025 |
2025.01 | 2025.01-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.47.1, jq 1.6, ubuntu 22.04.5 LTS, wget 1.21.2 Show more | 0.00 B | Jan 1, 2025 |
2025.01-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.47.1, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Jan 1, 2025 |
2024.12 | 2024.12-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.47.1, jq 1.6, ubuntu 22.04.5 LTS, wget 1.21.2 Show more | 0.00 B | Dec 1, 2024 |
2024.12-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.47.1, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Dec 1, 2024 |
2024.11 | 2024.11-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.47.0, jq 1.6, ubuntu 22.04.5 LTS, wget 1.21.2 Show more | 0.00 B | Nov 1, 2024 |
2024.11-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.47.0, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Nov 1, 2024 |
2024.10 | 2024.10-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.46.2, jq 1.6, ubuntu 22.04.5 LTS, wget 1.21.2 Show more | 0.00 B | Oct 1, 2024 |
2024.10-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.46.2, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Oct 1, 2024 |
2024.09 | 2024.09-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.46.0, jq 1.6, ubuntu 22.04.4 LTS, wget 1.21.2 Show more | 0.00 B | Sep 1, 2024 |
2024.08 | 2024.08-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.46.0, jq 1.6, ubuntu 22.04.4 LTS, wget 1.21.2 Show more | 0.00 B | Aug 1, 2024 |
2024.08-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.46.0, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Aug 1, 2024 |
2024.07 | 2024.07-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.45.2, jq 1.6, ubuntu 22.04.4 LTS, wget 1.21.2 Show more | 0.00 B | Jul 1, 2024 |
2024.07-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.45.2, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Jul 1, 2024 |
2024.06 | 2024.06-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.45.2, jq 1.6, ubuntu 22.04.4 LTS, wget 1.21.2 Show more | 0.00 B | Jun 1, 2024 |
2024.06-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.45.2, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Jun 1, 2024 |
edge | edge-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.45.1, jq 1.6, ubuntu 22.04.4 LTS, wget 1.21.2 Show more | 0.00 B | May 27, 2024 |
2024.05 | 2024.05-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.43.2, jq 1.6, ubuntu 22.04.4 LTS, wget 1.21.2 Show more | 0.00 B | May 1, 2024 |
2024.05-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.43.2, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | May 1, 2024 |
2024.02 | 2024.02-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.43.2, jq 1.6, ubuntu 22.04.3 LTS, wget 1.21.2 Show more | 0.00 B | Feb 29, 2024 |
2024.02-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 25.0.3, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.24.5
v2.24.5, dockerize v0.8.0, git 2.43.2, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Feb 29, 2024 |
2024.01 | 2024.01-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 24.0.6, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.23.0
v2.23.0, dockerize v0.8.0, git 2.43.0, jq 1.6, ubuntu 22.04.3 LTS, wget 1.21.2 Show more | 0.00 B | Jan 1, 2024 |
2024.01-20.04 | none | build-essential 12.8ubuntu1.1, curl 7.68.0, docker 24.0.6, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.23.0
v2.23.0, dockerize v0.8.0, git 2.43.0, jq 1.6, ubuntu 20.04.6 LTS, wget 1.20.3 Show more | 0.00 B | Jan 1, 2024 |
2023.12 | 2023.12-22.04 | build-essential 12.9ubuntu3, curl 7.81.0, docker 24.0.6, docker-compose /usr/local/bin/docker-compose
Docker Compose version v2.23.0
v2.23.0, dockerize v0.8.0, git 2.43.0, jq 1.6, ubuntu 22.04.3 LTS, wget 1.21.2 Show more | 0.00 B | Dec 1, 2023 |
Variant images typically contain the same base software, but with a few additional modifications.
The PostGIS variant is the same PostgreSQL image but with PostGIS (and its several dependencies) pre-installed.
The PostGIS variant can be used by appending -postgis
to the end of an existing cimg/postgres
tag.
1
2
3
4
5
6
7
8
jobs:
build:
docker:
- image: cimg/go:1.17
- image: cimg/postgres:17.2.0-postgis
steps:
- checkout
- run: echo "Do things"
The legacy version of this image, circleci/postgres
had a RAM variant.
This is no longer the case.
We're determining how much of a performance increase does this variant actually give before we decide to bring it back.
If you used the legacy PostgreSQL image and you have data on the ram vs non-ram variant build times, please open a GitHub Issue and let us know.