docs: add macOS 26.x Tahoe PGLite WASM workaround + native Postgres setup guide#1671
Open
roysaurav wants to merge 1 commit into
Open
docs: add macOS 26.x Tahoe PGLite WASM workaround + native Postgres setup guide#1671roysaurav wants to merge 1 commit into
roysaurav wants to merge 1 commit into
Conversation
…etup guide PGLite's embedded WASM engine crashes on macOS 26.x (Tahoe) on Apple Silicon during engine initialization. This adds: - A Troubleshooting section in docs/INSTALL.md with step-by-step instructions for using native Homebrew PostgreSQL 17 + pgvector as a workaround - A callout in README.md's Troubleshooting section pointing users to the detailed setup guide Tested on macOS 26.5 (arm64), Bun 1.3.14, gbrain 0.41.29.0, PostgreSQL 17.10 (Homebrew), pgvector 0.8.0. All 102 schema migrations pass. gbrain doctor green.
Author
|
This PR documents the native PostgreSQL + pgvector workaround for the macOS 26.x PGLite WASM crash tracked in #223 and #1670. It links the workaround to both issues so that users running into this on macOS 26.x / Tahoe have a clear path to running gbrain locally while upstream fixes (like the PGLite WAL recovery in electric-sql/pglite#994 or Bun updates) are finalized. |
Author
|
@claude can you review it ? |
Author
|
@garrytan can you please review it ? |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PGLite's embedded WASM engine crashes on macOS 26.x (Tahoe) on Apple Silicon due to a WASM runtime bug. This PR adds documentation for the workaround: using native Homebrew PostgreSQL + pgvector instead of PGLite.
Changes
docs/INSTALL.md: Added a new "Troubleshooting" section with step-by-step instructions for setting up native Homebrew PostgreSQL 17 + pgvector as a workaroundREADME.md: Added a callout in the existing Troubleshooting section pointing users to the detailed setup guideTested on
All 102 schema migrations pass.
gbrain doctorgreen across the board. Full brain functionality verified:put,search,link,files upload-raw.Closes #1670