PostgreSQL with pgvector

pgvector extension injected into official PostgreSQL images.

This repository provides Dockerfiles and automated builds for PostgreSQL with the pgvector extension across multiple PostgreSQL versions and OS variants.

Supported Tags

The images are available on Docker Hub (docker.io) and GitHub Container Registry (ghcr.io).

Each combination is published under two tags:

• <postgres-version>-<os-variant> (e.g. 18-alpine) — built against the pgvector master branch, updated on every scheduled/triggered build.
• <postgres-version>-<os-variant>-<pgvector-version> (e.g. 18-alpine-0.8.1) — built against the latest stable pgvector release tag, pinned to that specific version.

PostgreSQL Version	OS Variant	Target Tags
18	Alpine, Bookworm, Trixie	18-alpine, 18-bookworm, 18-trixie (and -<pgvector-version> variants)
17	Alpine, Bookworm, Trixie	17-alpine, 17-bookworm, 17-trixie (and -<pgvector-version> variants)
16	Alpine, Bookworm, Trixie	16-alpine, 16-bookworm, 16-trixie (and -<pgvector-version> variants)
15	Alpine, Bookworm, Trixie	15-alpine, 15-bookworm, 15-trixie (and -<pgvector-version> variants)
14	Alpine, Bookworm, Trixie	14-alpine, 14-bookworm, 14-trixie (and -<pgvector-version> variants)
13	Alpine, Bookworm, Trixie	13-alpine, 13-bookworm, 13-trixie (and -<pgvector-version> variants)

Usage

Quick Start

Run a container with the image (e.g., Postgres 18 Alpine variant):

docker run --name pg-vector -e POSTGRES_PASSWORD=mysecretpassword -p 5432:5432 -d mehyaa/postgres-pgvector:18-alpine

Enable Extension

After starting the container, you must enable the extension in your database:

CREATE EXTENSION IF NOT EXISTS vector;

Docker Compose Example

services:
  db:
    image: ghcr.io/mehyaa/postgres-pgvector:18-alpine
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"

OS Variants

• Alpine: Based on alpine. Lightweight and small footprint.
• Bookworm: Based on debian:bookworm (current stable).
• Trixie: Based on debian:trixie (testing).

Building Locally

To build a specific version locally:

docker build -t postgres-pgvector:18-alpine ./18/alpine

License

This project is licensed under the MIT License - see the LICENSE file for details.