readme

Author: pyramation

Dockerfile

@@ -18,8 +18,6 @@ ARG PGSODIUM_VERSION
 RUN apk add --no-cache \
     git \
     build-base \
-    clang17 \
-    llvm17 \
     postgresql-dev \
     curl \
     # PostGIS dependencies
@@ -34,11 +32,11 @@ RUN apk add --no-cache \
 
 WORKDIR /build
 
-# pgvector
+# pgvector (disable LLVM bitcode)
 RUN git clone --branch v${PGVECTOR_VERSION} --depth 1 https://github.com/pgvector/pgvector.git && \
     cd pgvector && \
-    make -j$(nproc) && \
-    make install
+    make OPTFLAGS="" USE_PGXS=1 WITH_LLVM=no -j$(nproc) && \
+    make USE_PGXS=1 WITH_LLVM=no install
 
 # PostGIS with Tiger geocoder and address standardizer
 RUN curl -L https://download.osgeo.org/postgis/source/postgis-${POSTGIS_VERSION}.tar.gz | tar xz && \
@@ -73,5 +71,5 @@ RUN apk add --no-cache \
 COPY --from=builder /usr/local/lib/postgresql/ /usr/local/lib/postgresql/
 COPY --from=builder /usr/local/share/postgresql/ /usr/local/share/postgresql/
 
-LABEL org.opencontainers.image.source="https://github.com/constructive/docker"
+LABEL org.opencontainers.image.source="https://github.com/constructive-io/docker"
 LABEL org.opencontainers.image.description="PostgreSQL 17 with pgvector, PostGIS, Tiger geocoder, and pgsodium"

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Constructive
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,63 @@
+# Constructive Docker
+
+<p align="center" width="100%">
+   <img src="./img/logo.svg" alt="constructive" width="80"><br />
+</p>
+
+Lean PostgreSQL 17 image with essential extensions for modern applications.
+
+## Extensions
+
+| Extension | Description |
+|-----------|-------------|
+| [pgvector](https://github.com/pgvector/pgvector) | Vector similarity search for embeddings |
+| [PostGIS](https://postgis.net/) | Spatial and geographic data |
+| [Tiger Geocoder](https://postgis.net/docs/Extras.html#Tiger_Geocoder) | US address geocoding |
+| [pgsodium](https://github.com/michelp/pgsodium) | Encryption using libsodium |
+
+## Usage
+
+```bash
+# Pull the image
+docker pull ghcr.io/constructive-io/docker:latest
+
+# Run
+docker run -d \
+  --name postgres \
+  -e POSTGRES_PASSWORD=secret \
+  -p 5432:5432 \
+  ghcr.io/constructive-io/docker:latest
+```
+
+Enable extensions as needed:
+
+```sql
+CREATE EXTENSION vector;
+CREATE EXTENSION postgis;
+CREATE EXTENSION fuzzystrmatch;
+CREATE EXTENSION address_standardizer;
+CREATE EXTENSION postgis_tiger_geocoder;
+CREATE EXTENSION pgsodium;
+```
+
+## Build
+
+```bash
+make build    # Build image
+make test     # Build and verify extensions
+make run      # Run container
+make shell    # psql into container
+make clean    # Remove image
+```
+
+## GitHub Actions
+
+Images are automatically built and pushed to `ghcr.io` on:
+- Push to `main`
+- Tagged releases (`v*`)
+
+Multi-arch support: `linux/amd64` and `linux/arm64`
+
+## License
+
+MIT License - see [LICENSE](./LICENSE)