fix: prevent DocumentDB RUM extension crash on startup

- Set documentdb_core.rum_library_load_option = 'try_documentdb_extended_rum'
  (was defaulting to 'require' which causes FATAL when .so has missing deps)
- Wrap documentdb extensions in DO blocks so init script failures don't
  abort PG startup — PG stays healthy even if DocumentDB fails to load

Author: hanzo-dev

conf/postgresql.conf

@@ -55,5 +55,7 @@ cron.database_name = 'postgres'
 # pgvector specific - HNSW index build parallelism
 max_parallel_maintenance_workers = 4
 
-# pg_documentdb - RUM library load option (default for PG18: require_documentdb_extended_rum)
-# documentdb.rum_library_load_option = 'require_documentdb_extended_rum'
+# pg_documentdb - RUM library load option
+# Default is 'require_documentdb_extended_rum' which crashes if the .so has missing deps.
+# Use 'try' so PG starts even if the RUM extension fails to load.
+documentdb_core.rum_library_load_option = 'try_documentdb_extended_rum'

docker-entrypoint-initdb.d/01-extensions.sql

@@ -1,7 +1,20 @@
 -- Hanzo SQL: Enable extensions
+-- Using DO blocks so individual extension failures don't abort the init script.
 CREATE EXTENSION IF NOT EXISTS vector;
 CREATE EXTENSION IF NOT EXISTS pg_cron;
 CREATE EXTENSION IF NOT EXISTS postgis;
 CREATE EXTENSION IF NOT EXISTS tsm_system_rows;
-CREATE EXTENSION IF NOT EXISTS documentdb_core;
-CREATE EXTENSION IF NOT EXISTS documentdb;
+
+-- DocumentDB extensions may fail if shared_preload_libraries config differs;
+-- wrap in DO block to keep PG running regardless.
+DO $$ BEGIN
+  CREATE EXTENSION IF NOT EXISTS documentdb_core;
+EXCEPTION WHEN OTHERS THEN
+  RAISE WARNING 'documentdb_core extension not loaded: %', SQLERRM;
+END $$;
+
+DO $$ BEGIN
+  CREATE EXTENSION IF NOT EXISTS documentdb;
+EXCEPTION WHEN OTHERS THEN
+  RAISE WARNING 'documentdb extension not loaded: %', SQLERRM;
+END $$;