Skip to content

Document multi-process access - #702

Merged
simolus3 merged 4 commits into
mainfrom
multi-process-docs
Oct 20, 2026
Merged

simolus3 merged 4 commits into
mainfrom
multi-process-docs

Conversation

@simolus3

@simolus3 simolus3 commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

This documents extra considerations to be aware of when a client-side SQLite database with PowerSync is opened in multiple processes. In particular, this points out that calling connect() for the same database is a potentially expensive mistake, that multiple writers might block each other with SQLITE_BUSY errors and that update notifications aren't shared.

This also presents solutions, starting with ways to avoid multiple processes, restrictions that make multi-process access safe and workarounds to avoid SQLITE_BUSY errors if multiple processes are really needed.

AI use: I wrote the initial draft myself, then let Claude fix typos and restructure some things for clarity.

@mintlify

mintlify Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
powersync 🟢 Ready View Preview Oct 20, 2026, 9:02 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

Comment thread client-sdks/advanced/multi-process.mdx Resolved
Comment thread client-sdks/advanced/multi-process.mdx Resolved
Comment thread client-sdks/advanced/multi-process.mdx Resolved
Comment thread client-sdks/reference/swift.mdx Resolved
Comment thread client-sdks/reference/swift.mdx Resolved
@claude

claude Bot commented Oct 19, 2026

Copy link
Copy Markdown
Contributor

Note: Vale and link-check CI results weren't accessible in this review environment, so spelling/terminology/link findings from those checks aren't covered here — please confirm they pass separately.

@mintlify

mintlify Bot commented Oct 19, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
powersync 🟡 Building – Oct 19, 2026, 4:26 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

Comment thread client-sdks/advanced/multi-process.mdx Resolved
Comment thread client-sdks/advanced/multi-process.mdx Resolved
@simolus3

Copy link
Copy Markdown
Contributor Author

The two links work in a local preview for me, their definition is at the bottom of the page

@simolus3
simolus3 merged commit d54d16b into main Oct 20, 2026
6 of 7 checks passed
@simolus3
simolus3 deleted the multi-process-docs branch October 20, 2026 09:26

This branch was successfully deployed

1 active deployment
staging — 463df09c Deployed Oct 20, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants