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

# Install Gateway RPM/DEB package

> Install Gateway via traditional RPM/DEB binary installation for Linux environments.

The RPM/DEB installation method provides a traditional binary installation approach for Linux environments, offering native package management integration and `systemd` service control.

## Step 1: Download the installation package

Download the appropriate Gateway installer package for your Linux distribution from Nexus. The installers are available in the `automation-gateway5-releases` repository under Linux server-installers.

* For example, RPM-based systems: `iagctl-5.1.0-amd64-server.rpm`
* For example, DEB-based systems: `iagctl-5.1.0-amd64-server.deb`

If downloading to a different machine, transfer the package to your target server:

```bash
scp /path/to/installer <your-user>@<server-hostname-or-ip>:/tmp
```

## Step 2: Install the package

Update the `version` and `arch` to reflect the version you downloaded before running the example installation commands.

**Debian installation**

```bash
sudo apt install ./iagctl-<version>-<arch>-server.deb
```

**RPM installation**

```bash
sudo dnf localinstall ./iagctl-<version>-<arch>-server.rpm
```

## Step 3: Configure user permissions

Add your user to the itential group to access installed files:

```bash
sudo usermod -aG itential $USER
```

Log out and back in to ensure group changes take effect.

## Step 4: Verify installation

Confirm the gateway server is running:

```bash
sudo systemctl status iagctl
```

**Expected Output**:

```
2024-09-27T15:18:39Z INF using configuration file at /etc/gateway/gateway.conf
2024-09-27T15:18:39Z INF using local store database file at gateway.db
2024-09-27T15:18:39Z INF starting gateway server
2024-09-27T15:18:39Z INF working directory is /etc/gateway
2024-09-27T15:18:39Z INF =================== CREATED TEMPORARY ADMIN
username: admin
password: admin
===================
2024-09-27T15:18:39Z INF starting grpc server on [::]:50051/tcp
```

## Post-installation tasks

Gateway is now installed. However, it is not yet connected to Gateway Manager or Itential Platform. For information on establishing these connections and other configuration procedures, see the subsequent steps.

1. [Set up certificates for secure communication](/itential-gateway/5/create-certificates)
2. [Configure server settings and Gateway Manager connectivity](/itential-gateway/5/initial-configuration#essential-configuration-settings)
3. [Install and configure gateway clients](/itential-gateway/5/client-configuration)
4. [Register your gateway cluster in Gateway Manager](/itential-gateway/5/create-gateway-cluster)