Amazon Neptune
User Guide (API Version 2017-11-29)

Adding Neptune Replicas to a DB Cluster

In a Neptune DB clusters, there is one primary DB instance and up to 15 Neptune Replicas. The primary DB instance supports read and write operations, and performs all of the data modifications to the cluster volume. Neptune Replicas connect to the same storage volume as the primary DB instance and support only read operations. Neptune Replicas can offload read workloads from the primary DB instance.

We recommend that you distribute the primary instance and Neptune Replicas in your DB cluster over multiple Availability Zones to improve the availability of your DB cluster.

You can add Neptune Replicas to a DB cluster using the AWS Management Console, the AWS CLI, or the Neptune API.

To remove a Neptune Replica from a DB cluster, delete the Neptune Replica DB instance by following the instructions in Deleting a DB Instance.

For more information about Neptune Replicas, see Neptune Replicas.

AWS Management Console

To add a Neptune Replica to a DB cluster

  1. Sign in to the AWS Management Console, and open the Amazon Neptune console at

  2. In the navigation pane, choose Instances, and then select the a DB instance in the DB cluster. The selected DB instance can be the primary DB instance for the DB cluster or a Neptune Replica.

  3. Choose Instance actions and then choose Create aurora replica.

    The Create Neptune replica page appears.

  4. On the Create Neptune replica page, specify options for your Neptune Replica. The following table shows settings for a Neptune Replica.

    For This Option Do This

    Availability zone

    Determine if you want to specify a particular Availability Zone. The list includes only those Availability Zones that are mapped by the DB subnet group you specified earlier.


    Select Enable encryption to enable encryption at rest for this Neptune Replica. For more information, see Encrypting Neptune Resources.

    DB instance class

    Select a DB instance class that defines the processing and memory requirements for the Neptune Replica. For more information about DB instance class options.

    Neptune replica source

    Select the identifier of the primary instance to create a Neptune Replica for.

    DB instance identifier

    Type a name for the instance that is unique for your account in the AWS Region you selected. You might choose to add some intelligence to the name such as including the AWS Region and DB engine you selected, for example gremlin-read-instance1.


    Choose a failover priority for the instance. If you don't select a value, the default is tier-1. This priority determines the order in which Neptune Replicas are promoted when recovering from a primary instance failure. For more information, see Fault Tolerance for a Neptune DB Cluster.

    Database port

    The port for a Neptune Replica is the same as the port for the DB cluster. The default is 8182.

    DB parameter group

    Select a parameter group. Neptune has a default parameter group you can use, or you can create your own parameter group. For more information about parameter groups, see Amazon Neptune DB Parameter Groups.

    Auto minor version upgrade

    Select Enable auto minor version upgrade if you want to enable your Neptune DB cluster to receive minor Engine version upgrades automatically when they become available.

    The Auto minor version upgrade option only applies to upgrades to minor engine versions for your Amazon Neptune DB cluster. It doesn't apply to regular patches applied to maintain system stability.

  5. Choose Create Neptune replica to create the Neptune Replica.