---
title: "replicationpeer create"
slug: "replicationpeer-create"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/replicationpeer-create"
---

> ## 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.

# replicationpeer create

This command creates a replication peer.

## Usage

```plaintext
replicationpeer create --name NAME
                       --remote-leading-vip REMOTE_LEADING_VIP
                       --local-vip-pool-id LOCAL_VIP_POOL_ID
                       --secure-mode NONE|SECURE
                       [--mss MSS]
[
```

## Required Parameters

| `--name NAME` | Specifies the name of the replication peer. |
| --- | --- |
| `--remote_leading-vip REMOTE_LEADING_VIP` | Specifies any one of the VIPs in the remote peer's replication [virtual IP pool](/docs-5-5/docs/managing-virtual-ip-pools#managing-virtual-ip-pools-via-vast-web-ui) to use as the remote leading virtual IP. The remote leading VIP is used to establish an initial connection between the peers. Once the connection is established, the peers share their external network topology and form multiple connections between the virtual IPs. |
| `--local-vip-pool-id LOCAL_VIP_POOL_ID` | Specifies the ID of the replication virtual IP pool on the local cluster. To create the replication virtual IP pool, use [vippool create](/docs-5-5/docs/vippool-create) and specify `--role REPLICATION`. |
| `--secure-mode NONE\|SECURE` | Set the secure mode for the replication peer configuration: - `SECURE`. Replication to this peer will be encrypted over the wire with mTLS. Secure mode requires a certificate, key and root certificate to be [uploaded to VMS](/docs-5-5/docs/encrypting-replication-with-mtls) for mTLS encryption. - `NONE`. Replication to this peer will not be encrypted over the wire. > [!CAUTION] > Caution > > This setting cannot be changed after creating the replication peer. |

## Options

| `--mss MSS` | Maximum segment size (MSS), in bytes, that the peer can receive in a single TCP segment. |
| --- | --- |

## Example

```plaintext
vcli: admin> replicationpeer create --name vastnativebackup --remote-leading-vip 198.51.100.200 --local-vip-pool-id 3
```