mehyaa/postgres-pgvector repository overview

⁠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.

⁠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.