﻿---
title: stack es ccr follow cli command
description: Create a follower. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://docs-v3-preview.elastic.dev/elastic/cli/pull/487/cli/stack/es/ccr/follow
---

# stack es ccr follow cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es ccr follow \
  --index <index> \
  --leader-index <leader-index> \
  --remote-cluster <remote-cluster> \
  [options]
```

Create a follower.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--index string required">
    The name of the follower index.
  </definition>
  <definition term="--leader-index string required">
    The name of the index in the leader cluster to follow.
  </definition>
  <definition term="--remote-cluster string required">
    The remote cluster containing the leader index.
  </definition>
  <definition term="--master-timeout string">
    Period to wait for a connection to the master node.
  </definition>
  <definition term="--wait-for-active-shards number">
    Specifies the number of shards to wait on being active before responding. This defaults to waiting on none of the shards to be active. A shard must be restored from the leader index before being active. Restoring a follower shard requires transferring all the remote Lucene segment files to the follower index.
  </definition>
  <definition term="--data-stream-name string">
    If the leader index is part of a data stream, the name to which the local data stream for the followed index should be renamed.
  </definition>
  <definition term="--max-outstanding-read-requests number">
    The maximum number of outstanding reads requests from the remote cluster.
  </definition>
  <definition term="--max-outstanding-write-requests number">
    The maximum number of outstanding write requests on the follower.
  </definition>
  <definition term="--max-read-request-operation-count number">
    The maximum number of operations to pull per read from the remote cluster.
  </definition>
  <definition term="--max-read-request-size number">
    The maximum size in bytes of per read of a batch of operations pulled from the remote cluster.
  </definition>
  <definition term="--max-retry-delay string">
    The maximum time to wait before retrying an operation that failed exceptionally. An exponential backoff strategy is employed when retrying.
  </definition>
  <definition term="--max-write-buffer-count number">
    The maximum number of operations that can be queued for writing. When this limit is reached, reads from the remote cluster will be deferred until the number of queued operations goes below the limit.
  </definition>
  <definition term="--max-write-buffer-size number">
    The maximum total bytes of operations that can be queued for writing. When this limit is reached, reads from the remote cluster will be deferred until the total bytes of queued operations goes below the limit.
  </definition>
  <definition term="--max-write-request-operation-count number">
    The maximum number of operations per bulk write request executed on the follower.
  </definition>
  <definition term="--max-write-request-size number">
    The maximum total bytes of operations per bulk write request executed on the follower.
  </definition>
  <definition term="--read-poll-timeout string">
    The maximum time to wait for new operations on the remote cluster when the follower index is synchronized with the leader index. When the timeout has elapsed, the poll for operations will return to the follower so that it can update some statistics. Then the follower will immediately attempt to read from the leader again.
  </definition>
  <definition term="--settings string">
    Settings to override from the leader index.
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--[no-]dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--[no-]json">
    output as JSON
  </definition>
</definitions>