ubuntu/postgresCurrent Postgres Docker Image from Canonical, based on Ubuntu. Receives security updates and rolls to newer Postgres or Ubuntu release. This repository is free to use and exempted from per-user rate limits.
PostgreSQL is a powerful, open source object-relational database system. It is fully ACID compliant, has full support for foreign keys, joins, views, triggers, and stored procedures (in multiple languages). It includes most SQL:2008 data types, including INTEGER, NUMERIC, BOOLEAN, CHAR, VARCHAR, DATE, INTERVAL, and TIMESTAMP. It also supports storage of binary large objects, including pictures, sounds, or video. It has native programming interfaces for C/C++, Java, .Net, Perl, Python, Ruby, Tcl, ODBC, among others, and exceptional documentation. Read more on the PostgreSQL website.
!LTS Up to 5 years of free security maintenance on LTS channels.
!ESM Up to 10 years of customer security maintenance from Canonical's restricted repositories.
| Channel Tags | Supported until | Currently | Architectures |
|---|---|---|---|
14-22.04_beta | 04/2027 | Postgres 14 on Ubuntu 22.04 LTS | amd64, arm64, ppc64el, s390x |
12-20.04_beta | 04/2025 | Postgres 12.4 on Ubuntu 20.04 LTS | amd64, arm64, ppc64el, s390x |
track_risk |
Channel Tags shows the most stable channel for that track ordered stable, candidate, beta, edge. More risky channels are always implicitly available. So if beta is listed, you can also pull edge. If candidate is listed, you can pull beta and edge. When stable is listed, all four are available. Images are guaranteed to progress through the sequence edge, beta, candidate before stable.
If your usage includes commercial redistribution, or requires ESM or unavailable channels/versions, please get in touch with the Canonical team (or using ***).
Launch this image locally:
shdocker run -d --name postgres-container -e TZ=UTC -p 30432:5432 -e POSTGRES_PASSWORD=My:s3Cr3t/ ubuntu/postgres:14-22.04_beta
Access your PostgreSQL server at localhost:30432.
| Parameter | Description |
|---|---|
-e TZ=UTC | Timezone. |
-e POSTGRES_PASSWORD=secret | Set the password for the superuser which is postgres by default. Bear in mind that to connect to the database in the same host the password is not needed but to access it via an external host (for instance another container) the password is needed. This option is mandatory and must not be empty. |
-e POSTGRES_USER=john | Create a new user with superuser privileges. This is used in conjunction with POSTGRES_PASSWORD. |
-e POSTGRES_DB=db_test | Set the name of the default database. |
-e POSTGRES_INITDB_ARGS="--data-checksums" | Pass arguments to the postgres initdb call. |
-e POSTGRES_INITDB_WALDIR=/path/to/location | Set the location of the Postgres transaction log. By default it is stored in a subdirectory of the main Postgres data folder (PGDATA). |
-e POSTGRES_HOST_AUTH_METHOD=trust | Set the auth-method for host connections for all databases, all users, and all addresses. The following will be added to the pg_hba.conf if this option is passed: host all all all $POSTGRES_HOST_AUTH_METHOD. |
-e PGDATA=/path/to/location | Set the location of the database files. The default is /var/lib/postgresql/data. |
-p 30432:5432 | Expose Postgres on localhost:30432. |
-v /path/to/postgresql.conf:/etc/postgresql/postgresql.conf | Local configuration file postgresql.conf (try this example). |
-v /path/to/persisted/data:/var/lib/postgresql/data | Persist data instead of initializing a new database every time you launch a new container. |
One can also add initialization scripts to their containers. This includes *.sql, .sql.gz, and *.sh scripts, and you just need to put them inside the /docker-entrypoint-initdb.d directory inside the container. After Postgres initialization is done and the default database and user are created, the scripts are executed in the following order:
*.sql files in alphabetically order. It will be executed with POSTGRES_USER.*.sh scripts in alphabetically order.*.sh scripts in alphabetically order.All of this is done before the Postgres service is started. Keep in mind if your PGDATA directory is not empty (contains pre-existing database) they will be left untouched.
To debug the container:
shdocker logs -f postgres-container
To get an interactive shell:
shdocker exec -it postgres-container /bin/bash
This image also includes the psql client for interactive container use:
sh$ docker network create postgres-network $ docker network connect postgres-network postgres-container $ docker run -it --rm --network postgres-network ubuntu/postgres:14-22.04_beta psql -h postgres-container -U postgres
The password will be asked and you can enter My:s3Cr3t/. Now, you are logged in and can enjoy your new instance.
Works with any Kubernetes; if you don't have one, we recommend you install MicroK8s and microk8s.enable dns storage then snap alias microk8s.kubectl kubectl.
Download
postgresql.conf and
postgres-deployment.yml and set containers.postgres.image in postgres-deployment.yml to your chosen channel tag (e.g. ubuntu/postgres:14-22.04_beta), then:
shkubectl create configmap postgres-config --from-file=main-config=postgresql.conf kubectl apply -f postgres-deployment.yml
You will now be able to connect to the Postgres server on localhost:30306.
If you find a bug in our image or want to request a specific feature, please file a bug here:
[***]
Please title the bug "postgres: <issue summary>". Make sure to include the digest of the image you are using, from:
shdocker images --no-trunc --quiet ubuntu/postgres:<tag>
These channels (tags) are not updated anymore. Please upgrade to newer channels, or reach out if you can't upgrade.
| Track | Version | EOL | Upgrade Path |
|---|---|---|---|
| Postgres 13.1 on Ubuntu 21.10 | 07/2022 | | |
| Postgres 13.1 on Ubuntu 21.04 | 01/2022 | | |
track |



探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像服务
在 Docker Desktop 配置镜像
Docker Compose 项目配置
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
在宝塔面板一键配置镜像
Synology 群晖 NAS 配置
飞牛 fnOS 系统配置镜像
极空间 NAS 系统配置服务
爱快 iKuai 路由系统配置
绿联 NAS 系统配置镜像
QNAP 威联通 NAS 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
免费版仅支持 Docker Hub 访问,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等;免费版仅支持 docker.io。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
来自真实用户的反馈,见证轩辕镜像的优质服务