How to install IceWarp using preinstalled image

Hyper-V or Vmware hypervisors are necessary to install the Fulltext server image. The image comes preloaded with a Linux distribution. Images can be downloaded from the IceWarp web download section. The installation process is very similar to the steps described in the Full-text-search related article.

Hyper-V installation

• Download the latest version of the IceWarp image for Hyper-V from our website here and extract it.
• Open your Hyper-V interface and Click on "Import new Virtual Machine..."

• Select the extracted folder and Click on "Next"
• Choose "Copy the virtual machine (create a new unique ID)" and click on "Next"
• Choose your location for the virtual machine; you can use the default path and click on "Next"
• Choose the location of the virtual machine's discs and click on "Next"
• Now you can select the proper Network card to connect to and make sure the network you choose is also available for the IceWarp server to connect to since the servers need to connect.
• Review the final recapitulation of the setup and click on "Finish"

Before you turn on the Virtual machine, It is recommended to increase the number of CPUs dedicated to the virtual machine. 

• Right-click on the imported Virtual machine and click on the settings
• Select "Processor" and grant the Virtual server at least 4 CPU cores and click apply

• Now you can turn on the Virtual Machine and continue to the “IceWarp Installation Guide” section.

  

VMware installation

• Download the latest version of the IceWarp image for VMware from our website here and extract it.
• Open your VMware program and click on Player > File > Open and select your extracted image.
• Name your virtual machine and select a destination for the storage path and click on "Import"

Before you turn on the Virtual machine, It is recommended to increase the number of CPUs dedicated to the virtual machine.

• Right-click on your imported Virtual machine

• Click on Processors and assign at least four cores to the Virtual Machine and click on "Ok"

• Now you can turn on the Virtual Machine and continue to the “IceWarp Installation Guide” section.

IceWarp Installation Guide

1. Initial Setup

1. Open the console in your hypervisor.
2. Log in as root using the default password displayed on screen.
3. Recommended: Run hostname -I to get the server's IP address, then switch to an SSH connection before continuing.

2. Running the Installer

1. Execute the installer:

   install-icewarp
   

2. Wait for the IceWarp Installation to initialize.

3. Configuration Steps

Step 1 — Create Your Domain

Enter your primary domain (e.g., example.com). This becomes the base for all user email addresses — your admin account will be admin@<domain> (e.g. admin@example.com).

Step 2 — Admin Password

The installer auto-generates a secure admin password. It is printed on screen and also saved to /tmp/iw_password.

Step 3 — License Key

Enter your existing IceWarp license key, or press Enter to automatically request a free 30-day trial license.

Step 4 — Database Dependency

The image includes Percona Server for MySQL. By default, IceWarp waits for the local Percona server to start before initializing.

• Press Enter (or type Y) to accept this default.
• Only select n if you plan to connect IceWarp to an external remote database.

4. Finalizing

1. The deployment script runs automatically. Wait approximately 2 minutes for it to complete.

2. Once you see Deployment completed!, open your browser and navigate to:

   https://<server-ip>
   

   For example: https://192.168.1.2

3. Log in using:
   • Username: admin@<your-domain>
   • Password: the password generated in Step 2