--- title: "Managing S3 Replication Peers" slug: "managing-s3-replication-peers" tags: ["5.5"] updated: 2026-10-27T23:00:54Z published: 2026-10-27T23:00:54Z canonical: "docs.vastdata.com/managing-s3-replication-peers" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Managing S3 Replication Peers Creating an S3 replication peer on a VAST Cluster enables you to: - Configure replication of the VAST Cluster's data to an AWS S3 or custom S3 bucket. - Access data that was already replicated to the peer from a client mount of the VAST Cluster's file system. You can have multiple S3 replication peers configured in parallel on a VAST Cluster. One active protected path can replicate the cluster's data to any one of the active peers. All restore points on all active peers are exposed to clients via the NFS export of the root directory of the file system. - [Creating an S3 Replication Peer via VAST Web UI](/docs-5-5/docs/managing-s3-replication-peers#creating-an-s3-replication-peer-via-vast-web-ui) - [Modifying an S3 Replication Peer via VAST Web UI](/docs-5-5/docs/managing-s3-replication-peers#modifying-an-s3-replication-peer-via-vast-web-ui) - [Removing an S3 Replication Peer via VAST Web UI](/docs-5-5/docs/managing-s3-replication-peers#removing-an-s3-replication-peer-via-vast-web-ui) - [Managing S3 Replication Peers via VAST CLI](/docs-5-5/docs/managing-s3-replication-peers#managing-s3-replication-peers-via-vast-cli) ## Viewing S3 Replication Peers via VAST Web UI - From the left navigation menu, select Data Protection and then S3 Replication Peers. For each replication peer, the following information can be displayed: > [!TIP] > Tip > > To display or hide fields, click ![column_menu.png](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/img-7f1bcc5ffaeed9cbf182efe768970783(184).png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A16%3A13Z&se=2026-11-08T10%3A16%3A13Z&sr=c&sp=r&sig=bxau8XTlc9NmyLZ1Tm4KuVP7URzK3%2F2GMx0R%2FAO%2Bjiw%3D) to the right of a column title, and then click ![columns.png](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/img-918b4797fca5961ded0a6026c39d1bb1(193).png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A16%3A13Z&se=2026-11-08T10%3A16%3A13Z&sr=c&sp=r&sig=bxau8XTlc9NmyLZ1Tm4KuVP7URzK3%2F2GMx0R%2FAO%2Bjiw%3D) to open a dropdown where you can select or unselect fields. - ID The ID of the S3 replication peer. - Name The name of the S3 replication peer. - State The state of the S3 replication peer. Possible values: - Active. The cluster is successfully connected to the peer. - Error. There is either an error connecting to the peer, either due to an authentication issue or a network issue. Check alarms for more detail. - Count. The peer is being initialized. - Bucket Name The name of the bucket. - Protocol The protocol through which the peer is accessed. - Proxies Proxies through which replication traffic is routed, if any. ## Creating an S3 Replication Peer via VAST Web UI This procedure configures an AWS S3 bucket as an S3 replication peer. The bucket can either be an AWS-hosted bucket or a bucket on a custom server that supports S3 object storage functionality. 1. Create the bucket that you want to replicate to. This can be either an AWS S3 bucket or a custom S3 bucket. For an AWS S3 bucket, prepare the following credentials: - Bucket name - AWS region - Access key pair For a custom S3 bucket, prepare the following credentials: - Bucket name - Access URL for the bucket - Access key pair 2. From the left navigation menu, select Data Protection and then S3 Replication Peers. 3. Click Create S3 Replication Peer. 4. Complete the fields: - Peer Name Enter a name for the S3 replication peer. - Bucket Name Enter the name of the bucket (up to 63 characters). - HTTP Protocol If *Peer Type* is *Custom S3*, select the HTTP protocol over which to access the target: - HTTP - HTTPS (Default) - Peer Type Select one of the following: - AWS S3. The peer is an AWS S3 bucket. - Custom S3. The peer is a custom S3 bucket. - Custom Bucket URL If you selected Custom S3 for *Peer Type*, enter the DNS name or IP address for the custom S3 service's store where the named bucket resides. A port number may be appended if required by the service. Do not include the bucket name or the access protocol here. Examples: - *198.51.100.0:9000*. - *storage.googleapis.com* - Aws Region If you selected AWS S3 for *Peer Type*, enter the name of the AWS region where the bucket resides. For example: *us-east-1*. - Secret Key Enter the secret key of a key pair for accessing the bucket. - Access Key Enter the access key of the same key pair as the secret key. - Proxies Optionally configure proxies here. If proxies are configured, replication traffic is routed via the proxies to and from the replication peer. Proxies can either be external to the cluster or they can run on a subset of the cluster's CNodes. To use a CNode as a proxy, first install third party proxy software on the CNode and then enter the proxy here. You can specify up to eight proxies. Traffic is load balanced between the specified proxies, excluding any inactive proxies if applicable. Enter each proxy in the format `http://<username>:<password>@<proxy IP>:<proxy port>`, in which `<username>` and `<password>` or the user name and password for authenticating to the proxy, `<proxy IP>` is the proxy's IP address and `<proxy port>` is the proxy port. For example: `http://admin:admin@192.0.2.0:8080,http://admin:admin@192.0.2.1:8080,http://admin:admin@192.0.2.2:8080` 5. Click Create. The replication peer is created and its details are displayed in the S3 Replication Peers page. Assuming the cluster can successfully access the target using the credentials you provided, the state will be displayed as ACTIVE. ## Modifying an S3 Replication Peer via VAST Web UI To modify the configuration of a peer, open the Actions menu for the peer and select Edit. Make your changes and then click Update. ## Removing an S3 Replication Peer via VAST Web UI To remove a peer, open the Actions menu for the peer and select Remove. Click Yes to confirm the removal. ## Managing S3 Replication Peers via VAST CLI To manage S3 replication peers via the [VAST CLI,](/docs-5-5/docs/using-the-vast-cli) use the following commands: | Task | Command | | --- | --- | | Display S3 replication peers | [s3replicationpeer list](/docs-5-5/docs/s3replicationpeer-list) | | Display details of a specific S3 replication peer | [s3replicationpeer show](/docs-5-5/docs/s3replicationpeer-show) | | Create a S3 replication peer | [s3replicationpeer create](/docs-5-5/docs/s3replicationpeer-create) | | Modify a S3 replication peer | [s3replicationpeer modify](/docs-5-5/docs/s3replicationpeer-modify) | | Delete a S3 replication peer | [s3replicationpeer delete](/docs-5-5/docs/s3replicationpeer-delete) |