> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-gateway/5/install-gateway-manager/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Install Gateway Manager

> Install Gateway Manager for on-premises deployments.

Gateway Manager is a platform application that enables secure connections between Itential Platform and your Itential Gateway deployments.

If you're using Itential Cloud, you can access Gateway Manager directly from the Itential Platform Dashboard—no installation required. Installation is only required for on-premises deployments.

**Version compatibility**

Gateway Manager is compatible with Gateway 5.1.0+, Itential Platform 2023.2.17+, and Itential Platform 6.0.4+.

## Download the Gateway Manager artifact

Download the Gateway Manager artifact from the Itential repository.

Before copying the example installation commands, replace `<version>` with the version number of the Gateway Manager artifact that you downloaded.

## Installation by Platform version

The installation process varies depending on your platform version.

### Itential Platform 6 installation

For Platform 6 installations, use the following RPM installation command:

```bash
rpm -Uh app-gateway_manager-<version>.noarch.rpm
```

The system installs the application in this default directory:

```bash
/opt/itential/platform/services
```

### Itential Platform 2023.2 installation

For Itential Platform 2023.2 installations, you must specify a custom installation directory using the `--prefix` flag:

```bash
rpm -Uh --prefix=/YOUR/INSTALL/DIR app-gateway_manager-<version>.noarch.rpm
```

Replace `YOUR/INSTALL/DIR` with your installation directory. Your install directory might look like:

```bash
/opt/itential/current/node_modules/@itential
```

If you installed Itential Platform using the bin installer, Platform might be running under the pronghorn user. In that case, run the following command:

```bash
sudo chown -R pronghorn:pronghorn /YOUR/INSTALL/DIR/app-gateway_manager
```

## Post-installation

After installation completes, Gateway Manager becomes available as a platform application and can be accessed from the Itential Platform Dashboard under the **Administration** collection.

Before you can connect your gateway deployments to Gateway Manager, you must create and upload a certificate to enable mutual TLS authentication between Gateway and Gateway Manager. This certificate ensures secure platform connectivity.

To get started, [create and upload Gateway Manager certificates](./create-certificates#gateway-manager-certificates).

### User authorization group

Before proceeding with the Gateway installation, verify that at least one group associated with your user has the proper Gateway Manager roles. For detailed information about these roles, see the RBAC in Gateway Manager page.

**To view your existing groups**:

1. Navigate to the Itential Platform Dashboard
2. Click **Admin Essentials** in the left navigation bar
3. Click **Authorization**
4. Click **Groups**

> Install Gateway Manager for on-premises deployments.