Skip to content

docs: cross region replication setup #3492

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.

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 7 commits into from
May 20, 2025
Merged
Changes from 1 commit
Commits
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
Prev Previous commit
Next Next commit
docs: update checklist
  • Loading branch information
danieltprice committed May 20, 2025
commit 7ea60a970df00729ebca00b77da337d9a1abfa56
37 changes: 31 additions & 6 deletions content/docs/get-started-with-neon/production-checklist.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@ updatedOn: '2025-05-11T11:23:50.618Z'

<CheckList title="Production checklist">

<CheckItem title="1. Set minimum compute to at least 1 vCPU" href="#set-minimum-compute-to-at-least-1-cu">
Make sure your default branch can handle production traffic. A higher minimum compute helps you avoid performance bottlenecks.
<CheckItem title="1. Configure a minimum compute size that can handle production traffic" href="#configure-a-minimum-compute-size-that-can handle-production-traffic">
Make sure your default branch can handle production traffic. A higher minimum compute can help you avoid performance bottlenecks.
</CheckItem>
<CheckItem title="2. Set max compute to the highest CU available for your plan" href="#set-max-compute-to-the-highest-cu-available-for-your-plan">
<CheckItem title="2. Enable autoscaling to handle usage spikes" href="#enable-autoscaling-to-handle-usage-spikes">
Set your compute to automatically scale up, allowing your app to handle traffic surges and stay performant without manual scaling.
</CheckItem>
<CheckItem title="3. Disable scale to zero" href="#disable-scale-to-zero">
Expand All @@ -38,13 +38,17 @@ updatedOn: '2025-05-11T11:23:50.618Z'
<CheckItem title="10. Upgrade to get priority support" href="#upgrade-to-a-neon-business-plan-for-priority-support">
Get faster support and priority handling for your production database with a Business plan.
</CheckItem>
<CheckItem title="11. Advanced: Set up cross-region replication" href="/docs/guides/logical-replication-neon-to-neon">
For added resilience, replicate your data to a Neon project in another region. This helps prepare for unlikely regional outages and can support failover strategies.
</CheckItem>

</CheckList>

<Steps>

## Set minimum compute to at least 1 CU
## Configure a minimum compute size that can handle production traffic

Before your application goes to prodution, make sure your database has enough vCPU and memory to handle expected production load. See [How to size your compute](/docs/manage/computes#how-to-size-your-compute).
Before your application goes to production, make sure your database has enough vCPU and memory to handle expected production load. See [How to size your compute](/docs/manage/computes#how-to-size-your-compute).

**Recommendation**

Expand All @@ -57,7 +61,7 @@ We recommend that you **fit your data in memory** and use Neon **autoscaling**:

A Compute Unit (CU) in Neon measures the processing power or "size" of a Neon compute. One CU includes 1 vCPU and 4 GB of RAM. Neon computes can range from **0.25** CUs to **56** CUs, depending on your [Neon plan](/docs/introduction/plans).

## Set max compute to the highest CU available for your plan
## Enable autoscaling to handle usage spikes

Use Neon's [autoscaling](/docs/guides/autoscaling-algorithm) feature to dynamically adjust your compute resources based on your current workload. This means you don't need to scale manually during traffic surges.

Expand Down Expand Up @@ -211,6 +215,27 @@ Upgrade to a [Business plan](/docs/introduction/plans#business) to get both [Pri

For more information, see the [Support documentation](/docs/introduction/support).

## Advanced: Set up cross-region replication

While not required for most applications, cross-region replication can provide an added layer of resilience for production environments. It allows you to replicate data from one Neon project to another in a different region — helping you prepare for unlikely regional outages or implement failover strategies.

**Recommendation**

Set up cross-region replication if your app requires high availability across regions or if you're building a disaster recovery plan.

**How it works**

Neon uses [logical replication](/docs/guides/logical-replication-neon-to-neon) to replicate data between Neon projects. You can replicate from a source project in one region to a destination project in another region, creating a near real-time copy of your data.

**Steps to get started**

- Follow the [guide to replicate data between Neon projects](/docs/guides/logical-replication-neon-to-neon)
- Set up a publication on your source database
- Create matching tables and a subscription on your destination database
- Test the replication and monitor for consistency

For full details, see [Replicate data from one Neon project to another](/docs/guides/logical-replication-neon-to-neon).

</Steps>

<NeedHelp/>