How to manage Read Replicas

Reviewed on April 08, 2025

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization
• A PostgreSQL or MySQL Database Instance
• Created a Read Replica

How to resync a Read Replica

When you resync a Read Replica, first it is reset, and then its data is resynchronized from the primary node. Your Read Replica will be unavailable during the resync process. The duration of this process is proportional to your Database Instance size. The configured endpoints will not change.

1. Click PostgreSQL and MySQL under Databases on the side menu. A list of your Database Instances displays.
2. Select the geographical region of the Instance you want to manage from the drop-down.
3. Click the database name or more icon > More info to access the Database Instance information page.
4. Scroll down to the Read Replica section.
5. Click more icon > Resync next to the name of the Read Replica you want to resync. A pop-up displays.
6. Make sure you have selected the correct Read Replica and click Resync. The list of your Read Replicas displays.

How to promote a Read Replica

It is possible to promote a Read Replica node to a standalone Database Instance.

1. Click PostgreSQL and MySQL under Databases on the side menu. A list of your Database Instances displays.

2. Select the geographical region of the Instance you want to manage from the drop-down.

3. Click the database name or more icon > More info to access the Database Instance information page.

4. Scroll down to the Read Replica section.

5. Click more icon > Promote Read Replica next to the name of the Read Replica you want to promote. A pop-up displays.

   Important

   Promoting a Read Replica is irreversible. Make sure that the main Database Instance node has completed all ongoing operations, and that the Read Replica lag is down to zero before promoting it. This helps ensure that the promoted Read Replica contains all operations from the main node.

   Note

   If the Read Replica you promote is attached to a Private Network, the resulting node will also be attached to the same Private Network. It will maintain the same private endpoint.

6. Click Promote Read Replica.

7. Go back to the list of your Database Instances. The promoted Read Replica appears.

   Important

   The new Instance originating from the Read Replica promotion will bear the prefix promoted, followed by the name of the original Database Instance that was replicated. You can change the name of your Database Instance on its overview page anytime. To do so, click edit icon next to its name.

How to manage Private Networks

You can attach and detach your Read Replica to a Private Network even after its creation.

Attach your Read Replica to a new Private Network

1. Click PostgreSQL and MySQL under Databases on the side menu. A list of your Database Instances displays.
2. Select the geographical region of the Instance you want to manage from the drop-down.
3. Click the database name or more icon > More info to access the Database Instance information page.
4. Scroll down to the Read Replica section.
5. Click more icon > Attach Private Network next to the name of your selected Read Replica. A pop-up displays.
6. Select Create and attach a new Private Network.
   Important

   Your private IP addresses are automatically allocated. They are managed via an IP Address Manager (IPAM). You can retrieve them on the Private Network tab of your Database Instance. To allocate IPs manually, you can use the Scaleway API and CLI, or Terraform/OpenTofu.

7. Click Attach Private Network.

Attach your Read Replica to an existing Private Network

1. Click PostgreSQL and MySQL under Databases on the side menu. A list of your Database Instances displays.
2. Select the geographical region of the Instance you want to manage from the drop-down.
3. Click the Database Instance name or more icon > More info to access the Database Instance information page.
4. Scroll down to the Read Replica section.
5. Click more icon > Attach Private Network next to the name of your selected Read Replica. A pop-up displays.
6. Select an existing Private Network to attach to your Read Replica.
   Important

   Your private IP addresses are automatically allocated. They are managed via an IP Address Manager (IPAM). You can retrieve them on the Private Network tab of your Database Instance. To allocate IPs manually, you can use the Scaleway API and CLI, or Terraform/OpenTofu.

7. Click Attach to Private Network to confirm.

Detach your Read Replica from a Private Network

If you already have an attached Private Network, you can detach it from your Read Replica.

1. Click PostgreSQL and MySQL under Databases on the side menu. A list of your Database Instances displays.
2. Select the geographical region of the Instance you want to manage from the drop-down.
3. Click the database name or more icon > More info to access the Database Instance information page.
4. Scroll down to the Read Replica section.
5. Click more icon > Detach Private Network next to the name of your selected Read Replica. A pop-up displays to ask if you are sure you want to detach the Private Network.
6. Click Detach Private Network to proceed. The list of your Read Replicas displays. The private endpoint is removed.

How to delete a public endpoint

Refer to the How to delete a public endpoint documentation page to do so for your Read Replica.

How to delete Read Replicas

1. Click PostgreSQL and MySQL under Databases on the side menu. A list of your Database Instances displays.
2. Select the geographical region of the Instance you want to manage from the drop-down.
3. Click the database name or more icon > More info to access the Database Instance information page.
4. Scroll down to the Read Replica section.
5. Click more icon > Delete. A pop-up appears.
   Important

   This is an irreversible that action permanently deletes your Read Replica and all its associated endpoints.

6. Click Delete Read Replica to do so. The list of your Read Replicas displays.