Articles in this section

See more

IceWarp Installation Guide for Red Hat 9

Avatar
IceWarp Support
  • Updated
Follow

Prerequisites

Before beginning the installation, ensure you have:

  • Root access to your Red Hat 9 server, RHEL 8, CentOS Stream 9, or Rocky Linux 9
  • SSH access configured
  • SCP (secure copy) capability for file transfer
  • Check the latest IceWarp release notes for specific OS version compatibility
  • Firewall rules – please refer to, specially if you have larger installation 

https://support.icewarp.com/hc/en-us/articles/6808711405585-IceWarp-recommended-network-ports

All mention here are TCP.

  • Needed incoming : 80, 443, 25, 465, 587, 993, 995, 1080, 5229, 32000, 32001
  • Needed outcoming: 25, 443, 80, 9001
  • optional incoming: 5222, 5223, 5269 – all 3 for xmpp
  • also will need to allow 22 for ssh access
  • Also setup DNS records – please refer to {DNS Configuration Guide for IceWarp}

Step 1: Download the Installation Package

  1. Navigate to the IceWarp downloads page: https://icewarp.com/downloads/download/
  2. Click on Installation package
  3. Select Red Hat 9 from the available options (or one that you are using)
  4. Copy the SHA256 checksum for verification (recommended)

Step 2: Verify the Download (Recommended)

To ensure the integrity of your download, verify the checksum:

sha256sum IceWarpServer-14.2.0_RHEL9_x64.tar.gz

Compare the output with the checksum you copied from the website. If they match, proceed to the next step. If they don't match, contact IceWarp support before continuing.

Step 3: Transfer the Package to Your Server

Use SCP to securely copy the installation package to your server:

scp IceWarpServer-14.2.0_RHEL9_x64.tar.gz root@yourserver:/tmp/

Note: You can choose a different destination directory instead of /tmp if preferred.

Step 4: Extract the Archive

Connect to your server via SSH:

ssh root@yourserver

Navigate to the directory where you uploaded the file (e.g., /tmp)

  • Extract the archive:
tar xvf IceWarpServer-14.2.0_RHEL9_x64.tar.gz

This may take a few seconds as the archive is around 1GB in size.

Step 5: Run the Installation Script

  • Change to the newly created directory:
cd IceWarpServer-14.2.0_RHEL9_x64
  • Execute the installation script:
sh install.sh

Step 6: Complete the Installation Wizard

The installation script will guide you through several steps:

  • License agreement: You'll need to read and accept the IceWarp EULA to continue. Press Enter to confirm after reading
  • Installation directory: Choose where IceWarp will be installed (you'll be prompted for the destination folder)
  • Package installation: The script will check for and offer to install any missing dependencies
  • Configuration options: Various prompts will appear with default options
  • Note: it is advised to install IceWarp under a system user other than root. To do this, create a user and group before running install.sh and then enter the user name when prompted by the installation wizard.

For most prompts:

  • Press Enter to accept the default option (indicated by a capital letter, e.g., [Y/n] or [y/N])
  • Type Y and press Enter to confirm actions
  • Read each prompt carefully to understand what the script is doing

Step 7: License Configuration

The final step requires license configuration. You have two options:

  • Enter your license key (Order ID) if you have purchased one
  • Choose trial mode to evaluate IceWarp with a 30-day trial (up to 100 users)

Post-Installation

Recommended: Migrate to MariaDB

For optimal performance and stability, IceWarp strongly recommends migrating from the default SQLite database to MariaDB or, if you have larger userbase use Percona. SQLite has limitations including:

  • No support for foreign keys
  • Limited scalability for larger deployments
  • Reduced functionality compared to MariaDB

Refer to the IceWarp documentation for the MariaDB migration process. You can find it here https://support.icewarp.com/hc/en-us/articles/360018895417-Linux-MariaDB-setup-for-IceWarp

Initial Configuration

  • Access the IceWarp web interface to complete your server configuration

All steps bellow you can do via /opt/icewarp/wizard.sh which will navigate you throuhg process.

  • Configure your domain settings
  • Set up user accounts
  • Review and adjust security settings
  • Configure mail server settings (SMTP, IMAP, POP3)

API Check for Dashboard Feature

EPOS includes a Dashboard feature that requires the server to be accessible from outside. The installation performs an API check to verify this connectivity. If you experience issues with this check, consult IceWarp support.

Troubleshooting

If you encounter any issues during installation:

  • Verify the SHA256 checksum matches the one from the website
  • Ensure all system requirements are met
  • Check that you have sufficient disk space (the archive is over 1GB)
  • Verify your server has internet connectivity for the API check
  • Ensure required repositories are available
  • Review the installation logs for specific error messages
  • Contact IceWarp support for assistance

Common Issues

  • Missing packages: The installer will detect and offer to install missing dependencies
  • API check failure: If the Dashboard API check fails, consult with IceWarp support or use the skip option if advised by their technicians
  • Extraction errors: Ensure you have enough disk space and proper permissions

Related articles

Comments

0 comments

Article is closed for comments.