PostgreSQL
The World's Most Advanced Open Source Relational Database on FreeBSD.
Shared (recommended) amd64 aarch64
Multi-arch manifests — resolve automatically to the right image for your platform.
Tag
Description
Best For
14 / 14-pkg
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
14-pkg-latest
FreeBSD Latest . Rolling package updates.
Staying current.
15 / 15-pkg
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
15-pkg-latest
FreeBSD Latest . Rolling package updates.
Staying current.
16 / 16-pkg
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
16-pkg-latest
FreeBSD Latest . Rolling package updates.
Staying current.
17 / 17-pkg
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
17-pkg-latest
FreeBSD Latest . Rolling package updates.
Staying current.
18 / 18-pkg / latest / pkg
FreeBSD Quarterly . Uses stable, tested packages.
Most users — recommended.
18-pkg-latest / pkg-latest
FreeBSD Latest . Rolling package updates.
Staying current.
Tag
Description
Best For
14-amd64 / 14-pkg-amd64
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
14-pkg-latest-amd64
FreeBSD Latest . Rolling package updates.
Staying current.
15-amd64 / 15-pkg-amd64
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
15-pkg-latest-amd64
FreeBSD Latest . Rolling package updates.
Staying current.
16-amd64 / 16-pkg-amd64
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
16-pkg-latest-amd64
FreeBSD Latest . Rolling package updates.
Staying current.
17-amd64 / 17-pkg-amd64
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
17-pkg-latest-amd64
FreeBSD Latest . Rolling package updates.
Staying current.
18-amd64 / 18-pkg-amd64 / latest-amd64 / pkg-amd64
FreeBSD Quarterly . Uses stable, tested packages.
Most users — recommended.
18-pkg-latest-amd64 / pkg-latest-amd64
FreeBSD Latest . Rolling package updates.
Staying current.
Tag
Description
Best For
14-aarch64 / 14-pkg-aarch64
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
14-pkg-latest-aarch64
FreeBSD Latest . Rolling package updates.
Staying current.
15-aarch64 / 15-pkg-aarch64
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
15-pkg-latest-aarch64
FreeBSD Latest . Rolling package updates.
Staying current.
16-aarch64 / 16-pkg-aarch64
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
16-pkg-latest-aarch64
FreeBSD Latest . Rolling package updates.
Staying current.
17-aarch64 / 17-pkg-aarch64
FreeBSD Quarterly . Uses stable, tested packages.
Production stability.
17-pkg-latest-aarch64
FreeBSD Latest . Rolling package updates.
Staying current.
18-aarch64 / 18-pkg-aarch64 / latest-aarch64 / pkg-aarch64
FreeBSD Quarterly . Uses stable, tested packages.
Most users — recommended.
18-pkg-latest-aarch64 / pkg-latest-aarch64
FreeBSD Latest . Rolling package updates.
Staying current.
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.
Deployment
Interactive Configuration
Parameters
Environment Variables
Variable
Default
Description
POSTGRES_USER
postgres
Database superuser name (default: postgres)
POSTGRES_PASSWORD
postgres
Database superuser password
POSTGRES_DB
postgres
Default database to create (default: same as user)
PUID
1000
PGID
1000
TZ
UTC
POSTGRES_INITDB_ARGS
``
Additional arguments for initdb
POSTGRES_HOST_AUTH_METHOD
``
Authentication method (default: scram-sha-256)
Volumes
Path
Description
/var/lib/postgresql/data
Database data directory
Ports
Port
Protocol
Description
5432
TCP
PostgreSQL port
Implementation Details
Architectures: amd64, aarch64
User: bsd (UID/GID set via PUID/PGID ). Defaults to 1000:1000.
Base: Built on ghcr.io/daemonless /base (FreeBSD 15.1).
sysvipc: Requires --annotation 'org.freebsd.jail.allow.sysvipc=true' (ocijail 0.5.0+ )
Need help? Join our Discord community.