Full config reference for service.yaml

[benitav]

Our drift agent pointed out a lot of undocumented config options for self-hosted instances, which inspired me to add a full reference (internal Slack ref).

Examples:

• [Drift] New storage.default_storage_version config option added (powersync-service #758) #574
• [Drift] Configurable Postgres snapshot socket timeout added (powersync-service #739) #573
• [Drift] MSSQL source connections add custom CA certificate and TLS servername options (powersync-service #750) #564
• [Drift] Object storage (S3) support added for MongoDB bucket storage V3, with configurable region and path style (powersync-service #728) #547
• [Drift] Configurable heartbeat interval added for MongoDB/Postgres/SQL Server replication; MongoDB now writes checkpoint heartbeats by default (powersync-service #747) #556

Main changes:

• Rewrote the Self-Hosted Instance Configuration page to include a better intro, better flow, and added a full service.yaml reference, covering all user-facing config options
• Claude Code verified every option in the reference against the powersync-service source code; fixed inaccuracies and added missing options
• Made sure to exclude deprecated and internal options from the reference (debug_api, block_local_jwks, use_legacy probe, internal telemetry endpoint)
• Added a section about the necessary permissions for MongoDB bucket storage

Other:

• Improved the Cloud Instances page with a proper intro, added a CLI tab for creating an instance, and generally just a better flow
• Added a shared snippet for the CLI instance creation steps, reused on the setup guide and Cloud Instances page
• Removed outdated SDK version mentions ("available since version X") across several pages where the version was very old

AI usage: Claude Code did most of the actual work - checking what's available and writing the content - using my guidance. It referenced the powersync-service repo for all available options and we then went through multiple review cycles (using the repo reviewer skills and my own manual review) to polish and improve readability. The Configuration Reference section would still benefit from a more technical review/once-over.

[mintlify]

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

Project	Status	Preview	Updated (UTC)
powersync	🟢 Ready	View Preview	Aug 19, 2026, 2:34 PM

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