Skip to main content

RPM/YUM Installation

Install MAPS Messaging on Red Hat–style distributions (RHEL, CentOS Stream, AlmaLinux, Rocky, Fedora) via YUM/DNF repositories. Supports both standard and ML editions.

Versions change over time. Replace examples with the desired release (e.g., 4.0.1).

1) Prerequisites​

  • RHEL 8/9, CentOS Stream 8/9, AlmaLinux/Rocky 8/9, or recent Fedora.
  • sudo privileges and outbound HTTPS access.
  • Java 21 available, if your environment does not provide a bundled runtime (java -version should report 21.x).

2) Add repositories (Release + Snapshot)​

Create the Release repo (enabled by default):

sudo tee /etc/yum.repos.d/mapsmessaging-release.repo >/dev/null <<'EOF'
[mapsmessaging-release]
name=MAPS Messaging - Release
baseurl=https://repository.mapsmessaging.io/repository/maps_yum_release/
enabled=1
gpgcheck=1
gpgkey=https://repository.mapsmessaging.io/repository/public_key/daily/apt_daily_key.gpg
repo_gpgcheck=0
EOF

Create the Snapshot repo (disabled by default):

sudo tee /etc/yum.repos.d/mapsmessaging-snapshot.repo >/dev/null <<'EOF'
[mapsmessaging-snapshot]
name=MAPS Messaging - Snapshot
baseurl=https://repository.mapsmessaging.io/repository/maps_yum_snapshot/
enabled=0
gpgcheck=1
gpgkey=https://repository.mapsmessaging.io/repository/public_key/daily/apt_daily_key.gpg
repo_gpgcheck=0
EOF

Refresh metadata:

sudo dnf clean all
sudo dnf makecache

Strategy: keep Release enabled, use Snapshot only when needed with --enablerepo=mapsmessaging-snapshot.

3) Install MAPS Messaging​

Standard edition

sudo dnf install maps

ML-enabled edition

sudo dnf install maps-ml

Install Snapshot explicitly (one-off)

sudo dnf --enablerepo=mapsmessaging-snapshot install maps
# or
sudo dnf --enablerepo=mapsmessaging-snapshot install maps-ml

4) Service management (systemd)​

# Enable & start
sudo systemctl enable --now maps         # standard
sudo systemctl enable --now maps-ml      # ML

# Status / logs
systemctl status maps
journalctl -u maps -n 200 --no-pager

5) Upgrades​

  • Regular upgrades (Release): 
    sudo dnf upgrade maps maps-ml
  • Use Snapshot just for the next operation: 
    sudo dnf --enablerepo=mapsmessaging-snapshot upgrade maps

6) Verify repository & packages​

dnf repolist | grep -i mapsmessaging
dnf info maps
dnf info maps-ml

7) Uninstall​

sudo systemctl disable --now maps || true
sudo systemctl disable --now maps-ml || true
sudo dnf remove maps maps-ml

8) Troubleshooting​

  • GPG key errors: ensure the key URL is reachable and re-make cache:

    sudo rpm --import https://repository.mapsmessaging.io/repository/public_key/daily/apt_daily_key.gpg
    sudo dnf clean all && sudo dnf makecache

  • Package not found: check repo files exist and are enabled, then:

    dnf repolist all | sed -n '/mapsmessaging/p'
    dnf search maps

  • Proxy / firewall: configure proxy= in repo files if needed, and allow outbound HTTPS to repository.mapsmessaging.io.