kgrozdanovski/pgvector repository overview

Convenient Docker images for Postgres images with pre-installed pgvector extension.

The goal is to simplify and speed-up image building on local and especially CI/CD environments.

All image variants are based on their official equivalents.

⁠Quick reference

⁠Maintained by:

Kristijan Grozdanovski⁠

Visit the GitHub repository⁠ for this project

⁠Where to get help:

the Docker Community Slack, Server Fault, Unix & Linux, or Stack Overflow

⁠Supported tags

• latest, 18, 18.6, 18-alpine, 18.6-alpine, 18-bookworm, 18.6-bookworm, 18-trixie, 18.6-trixie
• 17, 17.11, 17-alpine, 17.11-alpine, 17-bookworm, 17.11-bookworm, 17-trixie, 17.11-trixie
• 16, 16.15, 16-alpine, 16.15-alpine, 16-bookworm, 16.15-bookworm, 16-trixie, 16.15-trixie
• 15, 15.19, 15-alpine, 15.19-alpine, 15-bookworm, 15.19-bookworm, 15-trixie, 15.19-trixie
• 14, 14.24, 14-alpine, 14.24-alpine, 14-bookworm, 14.24-bookworm, 14-trixie, 14.24-trixie
• 13, 13.23, 13-alpine, 13.23-alpine, 13-bookworm, 13.23-bookworm
• 12, 12.22, 12-alpine, 12.22-alpine, 12-bookworm, 12.22-bookworm, 12-bullseye, 12.22-bullseye

⁠Where to file issues:

https://github.com/kgrozdanovski/pgvector/issues⁠

⁠What is pgvector?

pgvector is a PostgreSQL extension for vector similarity search. It can also be used for storing embeddings.

Read more here⁠.

⁠How to use this image

These images are drop-in replacements for their official Docker counterparts. Simply use these images as base images in your Dockerfile or Docker Compose specification, for example:

database:
  image: kgrozdanovski/pgvector:18.3-alpine
  restart: always
  environment:
    POSTGRES_USER=db_user
    POSTGRES_PASSWORD=db_password
    POSTGRES_DB=db_name
  volumes:
    - db-virtual-volume:/var/lib/postgresql/data:rw # persist data even if container shuts down
  ports:
    - "127.0.0.1:5432:5432"

⁠Image Variants

At the moment, the only variant offered is the Alpine image, which significantly speeds up local builds and pipelines which build Docker images.

My goal is to provide images for all flavors found in the official repo⁠ which make sense to me - currently this includes Base, Alpine and Bookworm variants for Postgres 12+, Bullseye for Postgres 12, plus Trixie for Postgres 14+.