We use cookies to personalise content and ads, to provide social media features and to analyse our traffic. You consent to our cookies if you continue to use our website. (learn more)

WebDocuments Setup Guide
for IceWarp Server 12.0.X

Integration with IceWarp WebDocuments allows to deploy IceWarp WebDocuments in several
ways, but we recommend running it on a separate server or at least in a separate virtual machine.

Do you have IceWarp Server 12.1 and later? Please find the setup guide here.

With this method, you will run WebDocuments on virtual machine preconfigured by us. If you prefer to run WebDocuments on your own Virtual Machine, check also option APT repository (VM with Debian8 is required).

This method is the easiest way for you to setup WebDocuments on Windows. With this method, you will run WebDocuments on a virtual machine preconfigured by Icewarp. If you prefer to run WebDocuments on your own Virtual Machine, check also option APT repository (VM with Debian8 is required).

This method seems to be the easiest way for you to setup WebDocuments on 64bit Debian 8.
You can either have standalone virtual server for WebDocuments or run WebDocuments on the same server as IceWarp.
In case of installation WebDocuments on same server as IceWarp, please conntact support.eu@icewarp.com for additional info.

Installing WebDocuments 1.0 on
a minimal version of Debian 9

Open terminal emulator note. Commands need to be run under 'root' account. Add apt sources of icewarp and nodejs repository:

Check if your Debian is able to install 'contrib' and 'non-free'packages.

- you should find this line in /etc/apt/sources.list file

deb http://ftp.uk.debian.org/debian/ stretch main contrib non-free

Add apt sources of IceWarp and nodejs repository

echo "deb http://pkg.icewarp.com/debian icewarp gen1" > /etc/apt/sources.list.d/icewarp.list
echo "deb http://deb.nodesource.com/node_8.x stretch main" > /etc/apt/sources.list.d/nodejs.list

- It is also possible to use https in the source links, but in that case apt-transport-https package HAS TO be installed first.

Install 'sudo' package

apt-get install sudo

Install 'dirmngr' - managing and downloading OpenPGP and X.509 certificates

apt-get install dirmngr

Install 'apt-transport-https' package to be able to use https source links

apt-get install apt-transport-https

Import signing keys into the apt keyring

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 948AD827

gpg: requesting key 948AD827 from hkp server keyserver.ubuntu.com
gpg: key 4291FC89: public key "IceWarp Technology <sysadmin@icewarp.com>" imported
gpg: Total number processed: 1
gpg: imported: 1 (RSA: 1)

apt-key adv --keyserver keyserver.ubuntu.com --recv 68576280

gpg: requesting key 68576280 from hkp server keyserver.ubuntu.com
gpg: key 68576280: public key "NodeSource >gpg@nodesource.com<" imported
gpg: Total number processed: 1
gpg:               imported: 1  (RSA: 1)

Update apt database on your machine

It is required to have added system locale en_US.UTF-8, to add en_US.UTF-8 execute dpkg-reconfigure locales
and check the checkbox for this locale

apt-get update && apt-get upgrade

Hit http://pkg.icewarp.com icewarp InRelease
Hit https://deb.nodesource.com stretch InRelease
Hit http://pkg.icewarp.com icewarp/gen1 amd64 Packages
Get:14 https://deb.nodesource.com stretch/main amd64 Packages [964 B]
Get:15 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:16 https://deb.nodesource.com stretch/main Translation-en [162 B]
Get:17 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:18 https://deb.nodesource.com stretch/main Translation-en [162 B]
Get:19 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:20 https://deb.nodesource.com stretch/main Translation-en [162 B]
Get:21 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:22 https://deb.nodesource.com stretch/main Translation-en [162 B]
Get:23 https://deb.nodesource.com stretch/main Translation-en_US [162 B]
Get:24 https://deb.nodesource.com stretch/main Translation-en [162 B]
Fetched xxx kB in xs (xx.x kB/s)
Reading package lists... Done

Install icewarp-webdocuments package

apt-get install icewarp-webdocuments

This package will install all necessary dependencies, so after approximately twenty minutes you will have configured and running backend for your web documents. The last line of script output is actual IP address of iwds host which is needed in next step, you can however obtain IP address in any common way.

Configure IceWarp server

  • Obtain IP address assigned to installed machine. It should be visible on terminal (or SSH login screen) under the IceWarp logo. Open IceWarp Administration Console and insert IP address of iwds host into "WebDocuments server connection" input located at GroupWare -> WebClient -> WebDocuments tab
  • Enable "WebDocuments Service"
  • Check that the configuration is correct by clicking "Test Connection" button (image iwdoc-iwserver-setup.jpg). "Test Connection" check will also configure iwds service for interoperation with IceWarp Server.
  • Save configuration changes by clicking on Apply button
  • Restart the Groupware service

Review TeamChat URL settings located at System -> Smartdiscover tab. URL must be reachable from iwds host. Also, IceWarp Server must be able to send out tcp packets to destination ports 8081, 80 or 443 on iwds host.