---
schema_version: "1"
id: 31975db0b0ecb0b8a5e87cd5fe1f26e58298fedb25f5ea655e3f7d714c8b2b20
title: Configuring Replicas for Flex Gateway in Connected Mode
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/gateway/1.9/flex-conn-rep-run.md
canonical_url: https://docs.mulesoft.com/gateway/1.9/flex-conn-rep-run
source_site: docs.mulesoft.com
content_type: documentation
content_hash: e06658f6f74c21cecc31ae128ecbe2f2579dcb2e7f3748e5c953e7afbdbb1d58
description: MuleSoft Documentation Site
release: "1.9"
latest: false
---
---
product: Omni Gateway
version: 1.9
---

# Configuring Replicas for Flex Gateway in Connected Mode

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

<table><colgroup><col> <col></colgroup><tbody><tr><td><div><div><p><span><a href="#add-a-flex-replica-as-a-linux-service"><img src="https://docs.mulesoft.com/gateway/1.9/_images/install-linux-logo.png" alt="20%" width="20%"></a></span></p></div></div></td><td><div><div><p><span><a href="#docker"><img src="https://docs.mulesoft.com/gateway/1.9/_images/install-docker-logo.png" alt="25%" width="25%"></a></span></p></div></div></td></tr><tr><td><div><div><p><a href="#add-a-flex-replica-as-a-linux-service">Add a Flex Replica as a Linux Service</a></p></div></div></td><td><div><div><p><a href="#docker">Add a Flex Replica in a Docker Container</a></p></div></div></td></tr></tbody></table>

## Flex Replicas

A Flex Replica is an instance of Flex Gateway. Setting up your gateway layer with multiple Flex
Gateway replicas enables the APIs deployed on Flex Gateway to serve more traffic.

When using Flex Gateway to manage APIs in production, configure more than one Flex Replica to avoid
a single point of failure. Running multiple Flex Replicas also increases performance if your API
service receives a significant amount of traffic.

## Before You Begin

Before getting started, ensure you have completed the following tasks:

- [Install a Flex Gateway](https://docs.mulesoft.com/gateway/1.9/flex-install)

- [Register and Run in Connected Mode](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run)

## Add a Flex Replica as a Linux Service

Adding a Flex Replica as a Linux Service includes the following tasks:

- Copy and paste the registration file created during registration to your Linux machine or VM.

- Run the Flex Gateway start command.

### Copy the Registration File

Copy the `registration.yaml` file to the following location on your Linux machine or VM:

- `/usr/local/share/mulesoft/flex-gateway/conf.d`

### Start Commands

Start Flex Gateway with the following command:

```ssh
sudo systemctl start flex-gateway
```

Verify that the Flex Gateway service is running successfully:

```ssh
systemctl list-units flex-gateway*
```

If `flex-gateway.service` has a status of `active`, Flex Gateway is successfully running.

```text
  UNIT                              LOAD   ACTIVE SUB     DESCRIPTION
  flex-gateway.service              loaded active running Application
```

Now if you check in Runtime Manager after clicking **Flex Gateway** in the left navigation, your
Flex Gateway will have an additional replica listed. You may need to refresh the page.

## Add a Flex Replica in a Docker Container

To add a Flex Replica in a Docker Container you must run the Flex Gateway start command using the
same `registration.yaml` file created during registration. If you are running the container locally,
you will also need to use a different port.

### Start Command

Run the following start command in the same directory where you ran the registration command:

```ssh
docker run --rm \
-v "$(pwd)":/usr/local/share/mulesoft/flex-gateway/conf.d \
-p 8080:8080 \
mulesoft/flex-gateway
```

> [!NOTE] Specify an optional name you want to assign to your Flex Replica by including the
> following: `-e FLEX_NAME=<name-for-flex-replica> \`.

Now if you check in Runtime Manager after clicking **Flex Gateway** in the left navigation, your
Flex Gateway will have an additional replica listed. You may need to refresh the page.