---
schema_version: "1"
id: 3ba46f31b4a8c175f3a076b3e528a49c15fd2d21ba58d1dab4bcbd6e46a1cabf
title: Downloading Flex Gateway
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/gateway/1.9/flex-install.md
canonical_url: https://docs.mulesoft.com/gateway/1.9/flex-install
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 74e715956877cd61fb45fdee320f08b2a4838325e3af7e08a13687f464943c55
description: MuleSoft Documentation Site
release: "1.9"
latest: false
---
---
product: Omni Gateway
version: 1.9
---

# Downloading Flex Gateway

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

Download and install Flex Gateway as a Linux service, or download the Flex Gateway image from the
container registry. Downloading is a prerequisite to registering and running a gateway as a Linux
service or in a container, Kubernetes cluster, or OpenShift cluster.

To run Flex Gateway inside a virtual machine (VM), download and install it as a Linux service. To
run Flex Gateway in a container, Kubernetes cluster, or OpenShift cluster, download the Flex Gateway
image.

<table><colgroup><col> <col> <col> <col></colgroup><tbody><tr><td><div><div><p><span><a href="#linux"><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="#container"><img src="https://docs.mulesoft.com/gateway/1.9/_images/install-container-logo.png" alt="25%" width="25%"></a></span></p></div></div></td><td><div><div><p><span><a href="#kubernetes"><img src="https://docs.mulesoft.com/gateway/1.9/_images/install-kubernetes-logo.png" alt="20%" width="20%"></a></span></p></div></div></td><td><div><div><p><span><a href="#openshift"><img src="https://docs.mulesoft.com/gateway/1.9/_images/install-openshift-logo.png" alt="20%" width="20%"></a></span></p></div></div></td></tr><tr><td><div><div><p><a href="#linux">Linux</a></p></div></div></td><td><div><div><p><a href="#container">Container</a></p></div></div></td><td><div><div><p><a href="#kubernetes">Kubernetes</a></p></div></div></td><td><div><div><p><a href="#openshift">OpenShift</a></p></div></div></td></tr></tbody></table>

See [Requirements and Limits for Flex Gateway](https://docs.mulesoft.com/gateway/1.9/flex-review-prerequisites) for details about hardware
and software requirements.

## Download and Install as a Linux Service

You can download and install Flex Gateway as a service in one of the following Linux environments:

#### ![2%](/mulesoft/current/en-us/gateway/1.9/_images/install-ubuntu-logo.png) Ubuntu

Download and install Flex Gateway as an Ubuntu service

##### Software Requirements

Flex Gateway runs on the following Long Term Support (LTS) versions of Ubuntu:

- Ubuntu (Focal, Jammy)

##### Before You Begin

Before getting started, ensure that you have installed the following:

- [gnupg2](https://gnupg.org/)

- [lsb\_release](https://refspecs.linuxfoundation.org/LSB_3.0.0/LSB-PDA/LSB-PDA/lsbrelease.html)

##### Run Installation Commands

To download and install Flex Gateway as a Ubuntu service, run the command block that performs the
following actions:

- Retrieves the public package keys and adds the package repository

- Updates the package list

- Updates `apt-get`

- Installs the Flex Gateway package

```ssh
curl -XGET https://flex-packages.anypoint.mulesoft.com/ubuntu/pubkey.gpg | sudo apt-key add -
echo "deb [arch=amd64] https://flex-packages.anypoint.mulesoft.com/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/mulesoft.list
sudo apt update
sudo apt install -y flex-gateway
```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

#### ![2%](/mulesoft/current/en-us/gateway/1.9/_images/install-debian-logo.png) Debian

Download and install Flex Gateway as a Debian service

##### Software Requirements

Flex Gateway runs on the following Long Term Support (LTS) versions of Debian:

- Debian (Bullseye, Bookworm)

##### Before You Begin

Before getting started, ensure that you have installed the following:

- [gnupg2](https://gnupg.org/)

- [lsb\_release](https://refspecs.linuxfoundation.org/LSB_3.0.0/LSB-PDA/LSB-PDA/lsbrelease.html)

##### Run Installation Commands

To download and install Flex Gateway as a Debian service, run the command block that performs the
following actions:

- Retrieves the public package keys and adds the package repository

- Updates the package list

- Updates `apt-get`

- Installs the Flex Gateway package

```ssh
curl -XGET https://flex-packages.anypoint.mulesoft.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb [arch=amd64] https://flex-packages.anypoint.mulesoft.com/debian $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/mulesoft.list
sudo apt update
sudo apt install -y flex-gateway
```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

#### ![2%](/mulesoft/current/en-us/gateway/1.9/_images/install-amazon-linux-logo.png) Amazon Linux

Download and install Flex Gateway as an Amazon Linux service

##### Software Requirements

Flex Gateway runs on the following Long Term Support (LTS) version of Amazon Linux:

- Amazon Linux 2023

##### Before You Begin

Before getting started, ensure that you have installed the following:

- [gnupg2](https://gnupg.org/)

##### Run Installation Commands

To download and install Flex Gateway as an Amazon Linux service, run the command block that performs
the following actions:

- Adds the Flex Gateway package repository with a reference to its public key

- Installs the Flex Gateway package

```ssh
sudo tee /etc/yum.repos.d/flex-gateway.repo <<\EOF
[flex-gateway]
name = Anypoint Flex Gateway
baseurl = https://flex-packages.anypoint.mulesoft.com/amazonlinux/2023/main
gpgcheck=1
gpgkey=https://flex-packages.anypoint.mulesoft.com/amazonlinux/pubkey.gpg
repo_gpgcheck=1
enabled=1
EOF

sudo yum install -y flex-gateway
```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

#### ![2%](/mulesoft/current/en-us/gateway/1.9/_images/install-rhel-logo.png) Red Hat Enterprise Linux

Download and install Flex Gateway as a Red Hat Enterprise Linux service

##### Software Requirements

Flex Gateway runs on the following Long Term Support (LTS) versions of RHEL:

- Red Hat Enterprise Linux (9)

##### Before You Begin

Before getting started, ensure that you have installed the following:

- [gnupg2](https://gnupg.org/)

##### Run Installation Commands

To download and install Flex Gateway as a Red Hat Enterprise Linux service, run the command block
that performs the following actions:

- Adds the Flex Gateway package repository with a reference to its public key

- Installs the Flex Gateway package

```ssh
sudo tee /etc/yum.repos.d/flex-gateway.repo <<\EOF
[flex-gateway]
name = Anypoint Flex Gateway
baseurl = https://flex-packages.anypoint.mulesoft.com/rhel/$releasever/main
gpgcheck=1
gpgkey=https://flex-packages.anypoint.mulesoft.com/rhel/pubkey.gpg
repo_gpgcheck=1
enabled=1
EOF

sudo yum install -y flex-gateway
```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

#### ![6%](/mulesoft/current/en-us/gateway/1.9/_images/install-rhel-ibm-logo.png) Red Hat Enterprise Linux on IBM Power

Download and install Flex Gateway as a Red Hat Enterprise Linux service on IBM Power

##### Software Requirements

Flex Gateway runs on the following Long Term Support (LTS) versions:

- Red Hat Enterprise Linux (9) on IBM Power (ppc64le)

##### Before You Begin

Before getting started, ensure that you have installed the following:

- [gnupg2](https://gnupg.org/)

##### Run Installation Commands

To download and install Flex Gateway as a Red Hat Enterprise Linux service, run the command block
that performs the following actions:

- Adds the Flex Gateway package repository with a reference to its public key

- Installs the Flex Gateway package

```ssh
sudo tee /etc/yum.repos.d/flex-gateway.repo <<\EOF
[flex-gateway]
name = Anypoint Flex Gateway
baseurl = https://flex-packages.anypoint.mulesoft.com/rhel/$releasever/main
gpgcheck=1
gpgkey=https://flex-packages.anypoint.mulesoft.com/rhel/pubkey.gpg
repo_gpgcheck=1
enabled=1
EOF

sudo yum install -y flex-gateway
```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

#### ![2%](/mulesoft/current/en-us/gateway/1.9/_images/install-suse-logo.png) SUSE Linux Enterprise

Download and install Flex Gateway as a SUSE Linux Enterprise service

##### Software Requirements

Flex Gateway runs on the following Long Term Support (LTS) versions:

- SUSE Linux Enterprise (SLES 15 SP3)

##### Before You Begin

Before getting started, ensure that you have installed the following:

- [gnupg2](https://gnupg.org/)

##### Run Installation Commands

To download and install Flex Gateway as a SUSE Linux Enterprise service, run the command block that
performs the following actions:

- Adds the Flex Gateway package repository with a reference to its public key

- Installs the Flex Gateway package

```ssh
sudo rpm --import https://flex-packages.anypoint.mulesoft.com/suse/pubkey.gpg
sudo tee /etc/zypp/repos.d/flex-gateway.repo <<\EOF
[flex-gateway]
name = Anypoint Flex Gateway
baseurl = https://flex-packages.anypoint.mulesoft.com/suse/$releasever_major/main
gpgcheck = 1
gpgkey = https://flex-packages.anypoint.mulesoft.com/suse/pubkey.gpg
repo_gpgcheck = 1
enabled = 1
EOF

sudo zypper refresh -f flex-gateway
sudo zypper install -y flex-gateway
```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

#### ![6%](/mulesoft/current/en-us/gateway/1.9/_images/install-suse-ibm-logo.png) SUSE Linux Enterprise on IBM Power

Download and install Flex Gateway as a SUSE Linux Enterprise service on IBM Power

##### Software Requirements

Flex Gateway runs on the following Long Term Support (LTS) versions:

- SUSE Linux Enterprise (SLES 15 SP3) on IBM Power (ppc64le)

##### Before You Begin

Before getting started, ensure that you have installed the following:

- [gnupg2](https://gnupg.org/)

##### Run Installation Commands

To download and install Flex Gateway as a SUSE Linux Enterprise service on IBM Power, run the
command block that performs the following actions:

- Adds the Flex Gateway package repository with a reference to its public key

- Installs the Flex Gateway package

```ssh
sudo rpm --import https://flex-packages.anypoint.mulesoft.com/suse/pubkey.gpg
sudo tee /etc/zypp/repos.d/flex-gateway.repo <<\EOF
[flex-gateway]
name = Anypoint Flex Gateway
baseurl = https://flex-packages.anypoint.mulesoft.com/suse/$releasever_major/main
gpgcheck = 1
gpgkey = https://flex-packages.anypoint.mulesoft.com/suse/pubkey.gpg
repo_gpgcheck = 1
enabled = 1
EOF

sudo zypper refresh -f flex-gateway
sudo zypper install -y flex-gateway
```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

#### ![2%](/mulesoft/current/en-us/gateway/1.9/_images/install-centos-logo.png) CentOS

Download and install Flex Gateway as a CentOS service

##### Software Requirements

Flex Gateway runs on the following Long Term Support (LTS) version of CentOS:

- CentOS 8

##### Before You Begin

Before getting started, ensure that you have installed the following:

- [gnupg2](https://gnupg.org/)

##### Run Installation Commands

To download and install Flex Gateway as an CentOS service, run the command block that performs the
following actions:

- Adds the Flex Gateway package repository with a reference to its public key

- Installs the Flex Gateway package

```ssh
sudo tee /etc/yum.repos.d/flex-gateway.repo <<\EOF
[flex-gateway]
name = Anypoint Flex Gateway
baseurl = https://flex-packages.anypoint.mulesoft.com/centos/$releasever/main
gpgcheck=1
gpgkey=https://flex-packages.anypoint.mulesoft.com/centos/pubkey.gpg
repo_gpgcheck=1
enabled=1
EOF

sudo yum install -y flex-gateway
```

Due to issues with the CentOS package manager you might encounter the following error:

Error: Failed to download metadata for repo 'AppStream': Cannot prepare internal mirrorlist: No URLs
in mirrorlist

If you encounter this error, run the following command:

```ssh
sudo sed -i -e "s|mirrorlist=|#mirrorlist=|g" -e "s|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g" /etc/yum.repos.d/CentOS-*
```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

## Download Flex Gateway for Use in a Container

You can download and install Flex Gateway in one of the following containers:

#### ![2%](/mulesoft/current/en-us/gateway/1.9/_images/install-docker-logo.png) Docker

Download Flex Gateway for Use in a Docker Container

Download the Flex Gateway container image to prepare for registering and running a gateway in a
Docker container:

1.  Download the Flex Gateway Docker image:

    ```ssh
    docker pull mulesoft/flex-gateway:latest
    ```

2.  Verify that the download succeeded:

    ```ssh
    docker images mulesoft/flex-gateway
    ```

    When successful, the command lists the Flex Gateway container image, for example:

    ```text
    REPOSITORY                   TAG
    mulesoft/flex-gateway        latest
    ```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

#### ![2%](/mulesoft/current/en-us/gateway/1.9/_images/install-podman-logo.png) Podman

Download Flex Gateway for Use in a Podman Container

Download the Flex Gateway container image to prepare for registering and running a gateway in a
Podman container:

1.  Download the Flex Gateway container image:

    ```ssh
    podman pull docker.io/mulesoft/flex-gateway:latest
    ```

2.  Verify that the download succeeded:

    ```ssh
    podman images docker.io/mulesoft/flex-gateway
    ```

    When successful, the command lists the Flex Gateway container image, for example:

    ```text
    REPOSITORY                   TAG
    mulesoft/flex-gateway        latest
    ```

After downloading and installing, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run). For more detail, see
[Connected Mode vs. Local Mode](https://docs.mulesoft.com/gateway/1.9/#connected-mode-vs-local-mode).

## Download Flex Gateway for Use in a Kubernetes Cluster

Download the Flex Gateway container image to prepare for registering and running a gateway in a
Kubernetes cluster. You can use the following container runtimes:

**Docker**

1.  Download the Flex Gateway container image:

    ```ssh
    docker pull mulesoft/flex-gateway:latest
    ```

2.  Verify that the download succeeded:

    ```ssh
    docker images mulesoft/flex-gateway
    ```

    When successful, the command lists the Flex Gateway container image, for example:

    ```text
    REPOSITORY                   TAG
    mulesoft/flex-gateway        latest
    ```

After downloading the image, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run).

**Podman**

1.  Download the Flex Gateway container image:

    ```ssh
    podman pull docker.io/mulesoft/flex-gateway:latest
    ```

2.  Verify that the download succeeded:

    ```ssh
    podman images docker.io/mulesoft/flex-gateway
    ```

    When successful, the command lists the Flex Gateway container image, for example:

    ```text
    REPOSITORY                   TAG
    mulesoft/flex-gateway        latest
    ```

After downloading the image, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run).

## Download Flex Gateway for Use in an OpenShift Cluster

Download the Flex Gateway container image to prepare for registering and running a gateway in an
OpenShift cluster. You can use the following container runtimes:

**Docker**

1.  Download the Flex Gateway container image:

    ```ssh
    docker pull mulesoft/flex-gateway:latest
    ```

2.  Verify that the download succeeded:

    ```ssh
    docker images mulesoft/flex-gateway
    ```

    When successful, the command lists the Flex Gateway container image, for example:

    ```text
    REPOSITORY                   TAG
    mulesoft/flex-gateway        latest
    ```

After downloading the image, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run).

**Podman**

1.  Download the Flex Gateway container image:

    ```ssh
    podman pull docker.io/mulesoft/flex-gateway:latest
    ```

2.  Verify that the download succeeded:

    ```ssh
    podman images docker.io/mulesoft/flex-gateway
    ```

    When successful, the command lists the Flex Gateway container image, for example:

    ```text
    REPOSITORY                   TAG
    mulesoft/flex-gateway        latest
    ```

After downloading the image, register Flex Gateway in [Connected](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run) or
[Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run).

## See Also

- [Getting Started with Self-Managed Flex Gateway](https://docs.mulesoft.com/gateway/1.9/flex-gateway-getting-started)

- [Requirements and Limits for Flex Gateway](https://docs.mulesoft.com/gateway/1.9/flex-review-prerequisites)

- [Registering and Running Flex Gateway in Connected Mode](https://docs.mulesoft.com/gateway/1.9/flex-conn-reg-run)

- [Registering and Running Flex Gateway in Local Mode](https://docs.mulesoft.com/gateway/1.9/flex-local-reg-run)