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

# Configuring Replicas for Omni 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-an-omni-replica-as-a-linux-service"><img src="https://docs.mulesoft.com/gateway/1.13/_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.13/_images/install-docker-logo.png" alt="25%" width="25%"></a></span></p></div></div></td></tr><tr><td><div><div><p><a href="#add-an-omni-replica-as-a-linux-service">Add an Omni Replica as a Linux Service</a></p></div></div></td><td><div><div><p><a href="#docker">Add an Omni Replica in a Docker Container</a></p></div></div></td></tr></tbody></table>

## Omni Replicas

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

When using Omni Gateway to manage APIs in production, configure more than one Omni Replica to avoid
a single point of failure. Running multiple Omni 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 an Omni Gateway](https://docs.mulesoft.com/gateway/1.13/install)

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

## Add an Omni Replica as a Linux Service

Adding an Omni 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 Omni 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 Omni Gateway with the following command:

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

Verify that the Omni Gateway service is running successfully:

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

If `flex-gateway.service` has a status of `active`, Omni 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 **Omni Gateway** in the left navigation, your
Omni Gateway will have an additional replica listed. You may need to refresh the page.

## Add an Omni Replica in a Docker Container

To add an Omni Replica in a Docker Container you must run the Omni 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 Omni Replica by including the
> following: `-e FLEX_NAME=<name-for-flex-replica> \`.

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