extensions.json

{
  "postgresql_major": 18,
  "extensions": [
    {
      "name": "timescaledb",
      "package": "timescaledb",
      "control_file": "timescaledb.control",
      "shared_preload_libraries": ["timescaledb"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS timescaledb;",
      "category": "time-series",
      "enabled_by_default": false,
      "notes": "Required only for databases using TimescaleDB hypertables or compression."
    },
    {
      "name": "pg_stat_statements",
      "package": "postgresql_18",
      "control_file": "pg_stat_statements.control",
      "shared_preload_libraries": ["pg_stat_statements"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_stat_statements;",
      "category": "observability",
      "enabled_by_default": false,
      "notes": "Core contrib extension available from the PostgreSQL base image."
    },
    {
      "name": "vector",
      "package": "pgvector",
      "control_file": "vector.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS vector;",
      "category": "vector-search",
      "enabled_by_default": false,
      "notes": "Dense vector type and indexes."
    },
    {
      "name": "vchord",
      "package": "vectorchord",
      "control_file": "vchord.control",
      "shared_preload_libraries": ["vchord"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS vchord;",
      "category": "vector-search",
      "enabled_by_default": false,
      "notes": "VectorChord indexing extension."
    },
    {
      "name": "vchord_bm25",
      "package": "vchord-bm25",
      "control_file": "vchord_bm25.control",
      "shared_preload_libraries": ["vchord_bm25"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS vchord_bm25 CASCADE;",
      "category": "sparse-search",
      "enabled_by_default": false,
      "notes": "BM25 sparse ranking. Usually used with pg_tokenizer."
    },
    {
      "name": "pg_tokenizer",
      "package": "pg-tokenizer",
      "control_file": "pg_tokenizer.control",
      "shared_preload_libraries": ["pg_tokenizer"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_tokenizer;",
      "category": "sparse-search",
      "enabled_by_default": false,
      "notes": "Tokenizer support for BM25 search."
    },
    {
      "name": "age",
      "package": "age",
      "control_file": "age.control",
      "shared_preload_libraries": ["age"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS age;",
      "category": "graph",
      "enabled_by_default": false,
      "notes": "Apache AGE graph database extension."
    },
    {
      "name": "pgmq",
      "package": "pgmq",
      "control_file": "pgmq.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pgmq;",
      "category": "queue",
      "enabled_by_default": false,
      "notes": "Postgres-backed message queues."
    },
    {
      "name": "pg_cron",
      "package": "pg_cron",
      "control_file": "pg_cron.control",
      "shared_preload_libraries": ["pg_cron"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_cron;",
      "category": "operations",
      "enabled_by_default": false,
      "notes": "Requires cron.database_name for the database that owns jobs."
    },
    {
      "name": "pg_repack",
      "package": "pg_repack",
      "control_file": "pg_repack.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_repack;",
      "category": "maintenance",
      "enabled_by_default": false,
      "notes": "Online table and index reorganization."
    },
    {
      "name": "pg_partman",
      "package": "pg_partman",
      "control_file": "pg_partman.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_partman;",
      "category": "partitioning",
      "enabled_by_default": false,
      "notes": "Partition management extension."
    },
    {
      "name": "pg_ivm",
      "package": "pg_ivm",
      "control_file": "pg_ivm.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_ivm;",
      "category": "views",
      "enabled_by_default": false,
      "notes": "Incremental materialized view maintenance — refreshes only changed rows instead of full REFRESH. High value for analytics aggregations (finops cost rollups, dashboards) that would otherwise need full recompute on every write."
    },
    {
      "name": "pg_duckdb",
      "package": "pg_duckdb",
      "control_file": "pg_duckdb.control",
      "shared_preload_libraries": ["pg_duckdb"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_duckdb;",
      "category": "analytics",
      "enabled_by_default": false,
      "notes": "DuckDB-powered in-process OLAP analytics. Built against the locked nixos-26.05 DuckDB 1.5.2 library; databases must opt in with shared_preload_libraries and CREATE EXTENSION."
    },
    {
      "name": "wrappers",
      "package": "wrappers",
      "control_file": "wrappers.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS wrappers;",
      "category": "federation",
      "enabled_by_default": false,
      "notes": "Supabase FDW collection — S3/Garage, Stripe, BigQuery, Firebase, Airtable, Clickhouse, Redis as foreign tables. Useful for finops collector reading from Garage S3 or external billing APIs directly via SQL."
    },
    {
      "name": "rum",
      "package": "rum",
      "control_file": "rum.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS rum;",
      "category": "indexing",
      "enabled_by_default": false,
      "notes": "RUM index access method — full-text search with timestamp ordering in a single index scan. Faster than GIN + ORDER BY ts_rank for time-sorted full-text queries."
    },
    {
      "name": "hypopg",
      "package": "hypopg",
      "control_file": "hypopg.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS hypopg;",
      "category": "planning",
      "enabled_by_default": false,
      "notes": "Hypothetical indexes for query planning."
    },
    {
      "name": "pg_hint_plan",
      "package": "pg_hint_plan",
      "control_file": "pg_hint_plan.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_hint_plan;",
      "category": "planning",
      "enabled_by_default": false,
      "notes": "Planner hints for exceptional query tuning cases."
    },
    {
      "name": "plpgsql_check",
      "package": "plpgsql_check",
      "control_file": "plpgsql_check.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS plpgsql_check;",
      "category": "development",
      "enabled_by_default": false,
      "notes": "Static analysis and runtime checks for PL/pgSQL."
    },
    {
      "name": "pg_trgm",
      "package": "postgresql_18",
      "control_file": "pg_trgm.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_trgm;",
      "category": "search",
      "enabled_by_default": false,
      "notes": "Core contrib trigram indexes and fuzzy text matching."
    },
    {
      "name": "unaccent",
      "package": "postgresql_18",
      "control_file": "unaccent.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS unaccent;",
      "category": "search",
      "enabled_by_default": false,
      "notes": "Core contrib accent-insensitive text normalization."
    },
    {
      "name": "btree_gin",
      "package": "postgresql_18",
      "control_file": "btree_gin.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS btree_gin;",
      "category": "indexing",
      "enabled_by_default": false,
      "notes": "Core contrib B-tree operator classes for GIN indexes."
    },
    {
      "name": "btree_gist",
      "package": "postgresql_18",
      "control_file": "btree_gist.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS btree_gist;",
      "category": "indexing",
      "enabled_by_default": false,
      "notes": "Core contrib B-tree operator classes for GiST indexes."
    },
    {
      "name": "pgstattuple",
      "package": "postgresql_18",
      "control_file": "pgstattuple.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pgstattuple;",
      "category": "maintenance",
      "enabled_by_default": false,
      "notes": "Core contrib table and index bloat inspection."
    },
    {
      "name": "amcheck",
      "package": "postgresql_18",
      "control_file": "amcheck.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS amcheck;",
      "category": "maintenance",
      "enabled_by_default": false,
      "notes": "Core contrib index and relation corruption checks."
    },
    {
      "name": "pageinspect",
      "package": "postgresql_18",
      "control_file": "pageinspect.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pageinspect;",
      "category": "diagnostics",
      "enabled_by_default": false,
      "notes": "Core contrib low-level page inspection for incident debugging."
    },
    {
      "name": "postgres_fdw",
      "package": "postgresql_18",
      "control_file": "postgres_fdw.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS postgres_fdw;",
      "category": "federation",
      "enabled_by_default": false,
      "notes": "Core contrib foreign data wrapper for PostgreSQL-to-PostgreSQL access."
    },
    {
      "name": "pgcrypto",
      "package": "postgresql_18",
      "control_file": "pgcrypto.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pgcrypto;",
      "category": "security",
      "enabled_by_default": false,
      "notes": "Core contrib cryptographic helpers and random data functions."
    },
    {
      "name": "pg_prewarm",
      "package": "postgresql_18",
      "control_file": "pg_prewarm.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_prewarm;",
      "category": "operations",
      "enabled_by_default": false,
      "notes": "Core contrib cache warming for important tables and indexes."
    },
    {
      "name": "pgaudit",
      "package": "pgaudit",
      "control_file": "pgaudit.control",
      "shared_preload_libraries": ["pgaudit"],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pgaudit;",
      "category": "security",
      "enabled_by_default": false,
      "notes": "Detailed database audit logging. Preload and configure only where audit volume is acceptable."
    },
    {
      "name": "uuid-ossp",
      "package": "postgresql_18",
      "control_file": "uuid-ossp.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS \"uuid-ossp\";",
      "category": "compat",
      "enabled_by_default": false,
      "notes": "Legacy compat only. PG18 has gen_random_uuid() (v4) and uuidv7() as built-ins — no extension needed for new code. Enable only for existing apps calling uuid_generate_v4() that cannot be migrated."
    },
    {
      "name": "hstore",
      "package": "postgresql_18",
      "control_file": "hstore.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS hstore;",
      "category": "types",
      "enabled_by_default": false,
      "notes": "Core contrib key-value store type. Prefer JSONB for new code; enable for apps that use hstore columns."
    },
    {
      "name": "citext",
      "package": "postgresql_18",
      "control_file": "citext.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS citext;",
      "category": "types",
      "enabled_by_default": false,
      "notes": "Core contrib case-insensitive text type. Useful for email and username columns; simpler than lower() indexes."
    },
    {
      "name": "ltree",
      "package": "postgresql_18",
      "control_file": "ltree.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS ltree;",
      "category": "types",
      "enabled_by_default": false,
      "notes": "Core contrib hierarchical label tree type and operators. Efficient ancestor/descendant queries without recursive CTEs."
    },
    {
      "name": "intarray",
      "package": "postgresql_18",
      "control_file": "intarray.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS intarray;",
      "category": "types",
      "enabled_by_default": false,
      "notes": "Core contrib integer array functions and GiST/GIN indexes. Efficient set membership and intersection queries."
    },
    {
      "name": "pg_buffercache",
      "package": "postgresql_18",
      "control_file": "pg_buffercache.control",
      "shared_preload_libraries": [],
      "create_extension": "CREATE EXTENSION IF NOT EXISTS pg_buffercache;",
      "category": "diagnostics",
      "enabled_by_default": false,
      "notes": "Core contrib shared buffer cache inspection. Useful for diagnosing what is and isn't cached during performance investigation."
    }
  ]
}