Skip to content

Postgres Bucket Storage Server Compatibility #103

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 3, 2025
Merged

Postgres Bucket Storage Server Compatibility #103

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 9 additions & 4 deletions self-hosting/installation/powersync-service-setup.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -173,10 +173,6 @@ client_auth:

```

<Info>
**Important:** When using Postgres for sync bucket storage, a separate server is currently required for replication connections (if using Postgres for replication) and storage. Using the same server might cause unexpected results.
</Info>

Specify the connection to Postgres in the `replication` section. Retrieving your database connection string / individual parameters differs by database hosting provider. See [Database Connection](/self-hosting/appendix/database-connection) for further details.

<Info>
Expand All @@ -189,6 +185,15 @@ Specify the connection to Postgres in the `replication` section. Retrieving your

Specify the connection to your sync bucket storage provider (Postgres or MongoDB) in the `storage` section.

### Postgres Storage

Separate Postgres servers are required for replication connections and sync bucket storage **if using PostgreSQL versions below 14**.

| PostgreSQL Version | Server configuration |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Below 14 | Separate servers are required for the source and sync bucket storage. Replication will be blocked if the same server is detected. |
| 14 and above | The source database and sync bucket storage database can be on the same server. Using the same database (with separate schemas) is supported but may lead to higher CPU usage. Using separate servers remains an option. |

### Environment Variables

The config file uses custom tags for environment variable substitution.
Expand Down