{"id":279,"date":"2025-07-22T13:16:00","date_gmt":"2025-07-22T13:16:00","guid":{"rendered":"https:\/\/blog.hostinger.io\/support\/2025\/07\/22\/11823362-how-to-install-icewarp-epos-on-hostinger-vps\/"},"modified":"2025-07-22T13:16:00","modified_gmt":"2025-07-22T13:16:00","slug":"11823362-how-to-install-icewarp-epos-on-hostinger-vps","status":"publish","type":"post","link":"https:\/\/www.hostinger.com\/support\/11823362-how-to-install-icewarp-epos-on-hostinger-vps\/","title":{"rendered":"How to Install IceWarp EPOS on Hostinger VPS"},"content":{"rendered":"

IceWarp<\/a> EPOS is a full-featured mail and collaboration platform that you can install on your Hostinger VPS using Docker. This article will guide you through the process of deploying IceWarp in a containerized environment, using Docker Compose and environment variables for configuration.<\/p>

\n<\/p>

Prepare your VPS and system requirements<\/b><\/h2>

Before you begin, make sure your Hostinger VPS meets the basic resource recommendations. For up to 10 users, allocate at least 2 vCPUs and 4 GB of RAM<\/b>. If you expect more users or heavy usage (e.g., desktop sync clients), scale accordingly — IceWarp supports setups with 8+ vCPUs and 20+ GB RAM for larger deployments<\/p>

\n<\/p>

\n

Ensure your VPS is running a Hostinger VPS Docker template.<\/p>\n<\/div>

\n<\/p>

Download the example Docker compose file<\/b><\/h2>

Next, prepare your docker-compose.yml configuration file. IceWarp provides a reference file structure that includes all the services you’ll need — IceWarp, MariaDB, Redis, and Laforge (the thumbnail preview service). You can copy their official example and adjust it for your use case:<\/p>

version: \"3.9\"

services:
  icewarp:
    image: ${ICW_IMAGE_VERSION:-icewarptechnology\/icewarp-server:latest}
    platform: ${ICW_IMAGE_PLATFORM:-linux\/amd64}
    command:
      - \"\/usr\/bin\/supervisord\"
      - \"--nodaemon\"
      - \"-c\"
      - \"\/data\/supervisord\/supervisord.conf\"
    volumes:
      - iwserver-data:\/data
      - iwserver-cache-bash-history:\/commandhistory
    environment:
      LICENSE_ORDERID: \"${LICENSE_ORDERID}\"
      ICW_DOMAIN: ${ICW_DOMAIN}
      ADMIN_ACCOUNT_PASS: ${ADMIN_ACCOUNT_PASS}
      ADMIN_ACCOUNT_USER: ${ADMIN_ACCOUNT_USER:-admin}
      PUBLICHOSTNAME: ${PUBLICHOSTNAME}
      PUBLICIP: ${PUBLICIP:-}
      LOCALIP: ${LOCALIP:-}
      DNSSERVER: ${DNSSERVER:-}
      PREVIEWURL: ${PREVIEWURL:-http:\/\/laforge:25791}
      MARIADB_HOST: mariadb
      MARIADB_ROOT_USER: ${MARIADB_ROOT_USER:-root}
      MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD}
      REDIS_HOST: tcp:\/\/redis:6379
    ports:
      - \"25:25\/tcp\" # SMTP
      - \"80:80\/tcp\" # HTTP
      - \"110:110\/tcp\" # POP3
      - \"143:143\/tcp\" # IMAP
      - \"443:443\/tcp\" # HTTPS
      - \"465:465\/tcp\" # SMTPS
      - \"587:587\/tcp\" # SMTP
      - \"993:993\/tcp\" # IMAPS
      - \"995:995\/tcp\" # POP3S
      - \"1080:1080\/tcp\" # SOCKS
      - \"5060:5060\/udp\" # SIP
      - \"5060:5060\/tcp\" # SIP
      - \"5061:5061\/udp\" # SIP
      - \"5222:5222\/tcp\" # XMLL
      - \"5223:5223\/tcp\" # XMPP TLS
      - \"5269:5269\/tcp\" # Groupware
    depends_on:
      - mariadb
      - redis

  laforge:
    image: ${LAFORGE_IMAGE_VERSION:-icewarptechnology\/laforge:2.0.3}
    environment:
      LAFORGE_SERVER_HTTP_LISTEN: ${LAFORGE_SERVER_HTTP_LISTEN:-:25791}
    ports:
      - \"25791:25791\/tcp\"

  mariadb:
    image: ${MARIADB_IMAGE_VERSION:-docker.io\/library\/mariadb:10.6}
    environment:
      MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD}
    volumes:
      - iwserver-mariadb:\/var\/lib\/mysql

  redis:
    image: ${REDIS_IMAGE_VERSION:-docker.io\/library\/redis:6}
    command: \"--appendonly yes\"
    volumes:
      - iwserver-redis:\/data

volumes:
  iwserver-cache-bash-history:
  iwserver-data:
  iwserver-mariadb:
  iwserver-redis:<\/code><\/pre>
\n<\/p>
Create the environment configuration file<\/b><\/h2>
To securely configure your IceWarp environment, create a file named icewarp.env. This file will hold your essential environment variables, such as your license key, admin credentials, and domain name.<\/p>
\n<\/p>
Here’s a minimal example:<\/p>
# mandatory options
# -----------------

# IceWarp license key
LICENSE_ORDERID=\"CHANGE_ME\"
# MariaDB password
MARIADB_ROOT_PASSWORD=test1
# Precreated domain
ICW_DOMAIN=mydomain.net

# strongly recommended
# --------------------
# Precreated administrator account password, default username is admin
ADMIN_ACCOUNT_PASS=Testingpassword1
# MX domain
PUBLICHOSTNAME=mail.mydomain.net
# Configure Let’s Encrypt certificate for PUBLICHOSTNAME
CREATE_CERT=\"1\"<\/code><\/pre>
Save this file in the same directory as your docker-compose.yml.<\/p>
\n<\/p>
Deploy IceWarp using Docker compose<\/b><\/h2>
From the directory where your Docker files are saved, run the following command:<\/p>
docker-compose --env-file icewarp.env -f docker-compose.yml up -d<\/code><\/pre>
Docker will begin pulling necessary containers (MariaDB, Redis, Laforge) and start the IceWarp services.<\/p>
\n<\/p>
Access your IceWarp web interface<\/b><\/h2>
Once setup is complete, your IceWarp EPOS instance is running.<\/p>
\n<\/p>
To access it, use the IP address<\/b> of your VPS.<\/p>
\n<\/p>
Log in with the credentials you specified in the icewarp.env file.<\/p>
\n<\/p>
For more detailed IceWarp configuration options, advanced architecture planning, or multi-user scaling scenarios, refer to IceWarp’s official Architecture Guide<\/a> or reach out to their support team.<\/p>
\n<\/p>
\n<\/p>
\n<\/p>\n","protected":false},"excerpt":{"rendered":"
Step by step guide on how to install IceWarp on a VPS<\/p>\n","protected":false},"author":581,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"include_on_kodee":true,"footnotes":""},"categories":[199],"tags":[],"class_list":["post-279","post","type-post","status-publish","format-standard","hentry","category-vps-management"],"hreflangs":[{"locale":"en-US","link":"https:\/\/www.hostinger.com\/support\/11823362-how-to-install-icewarp-epos-on-hostinger-vps\/","default":1}],"include_on_kodee":true,"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/279","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/users\/581"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/comments?post=279"}],"version-history":[{"count":0,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/279\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/media?parent=279"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/categories?post=279"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/tags?post=279"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}