print PDF
Installation of Sqwebmail on a dedicated server

To obtain sources

The official site will allow you to obtain sources. Next, you will just have to download them via a simple wget of your server. You may download the version you wish directly via this url:

Few useful links:,


For the example, we will use sqwebmail-4.0.7 (latest version when creating the guide) on a dedicated server

  • Installation of sources on a server

First of all, connect to the server in ssh (see SshOnDedicated):

$ ssh
Last login: Fri Dec 12 10:18:19 2003 from XXXXXXXXXX
Red Hat Linux release 7.2 (Enigma)
Linux 2.4.23 #1 lun déc 1 21:20:36 CET 2003 i686 unknown

machine : XXX
release : 1.45
ip : 213.186.XX.X
hostname :
[root@nsXXXX root]# wget -O /home/ovh/src/soft/sqwebmail-4.0.7.tar.bz2
[root@nsXXXX root]# cd /home/ovh/src
[root@nsXXXX src]# tar -xjf soft/sqwebmail-4.0.7.tar.bz2

The installation is carried out by placing data in the directory /home/ovh/src, directory containing all softs compiled on dedicated.

  • Compilation

To start, let’s have a look on the basic setting we used to have in the previous version of sqwebmail by looking in config.status file.

[root@nsXXXX src]# ls -ld sqwebmail*
drwxrwxrwx 24 alias users 4096 sep 12 10:48 sqwebmail-
drwxrwxrwx 24 alias users 4096 déc 12 17:26 sqwebmail-4.0.7

We edit ‘config.status’ file with our favourite editor:

[root@nsXXXX src]# vi sqwebmail-


[root@nsXXXX src]# pico sqwebmail-


From there, we will be able to recover the basic setting for sqwebmail, on our side we found:

exec /bin/sh ./configure '--enable-cgibindir=/home/ovh/cgi-bin/' '--enable-imagedir=/home/ovh/www/webmail' '--with-authvchkpw' '--without-authpam' '--without-authuserdb' '--without-authpwd' '--without-authshadow' '--without-authldap' '--without-authdaemon' --with-db=gdbm --with-userdb=/etc/userdb --with-formdata --enable-utf7-folder-encoding --enable-unicode=iso-8859-1,utf-8 --prefix=/usr/local/share/sqwebmail --with-makedatprog=${prefix}/libexec/sqwebmail/makedatprog-with-authchangepwdir=${prefix}/libexec/authlib --with-authdaemonvar=/usr/local/share/sqwebmail/var/authdaemon --sysconfdir=/usr/local/share/sqwebmail --with-package=sqwebmail --with-version= --without-socks --no-create --no-recursion

We will adapt our command ./configure in comparison with it, here is what we found:

[root@nsXXXX src]# cd sqwebmail-4.0.7
[root@nsXXXX sqwebmail-4.0.7]# ./configure --enable-cgibindir=/home/ovh/cgi-bin/ --enable-imagedir=/home/ovh/www/webmail --with-authvchkpw --without-authpam --without-authuserdb --without-authpwd --without-authshadow --without-authldap --without-authdaemon --with-db=gdbm --with-userdb=/etc/userdb --with-formdata --enable-utf7-folder-encoding --enable-unicode=iso-8859-1,utf-8 --prefix=/usr/local/share/sqwebmail --with-makedatprog=/usr/local/share/sqwebmail/libexec/sqwebmail/makedatprog-with-authchangepwdir=/usr/local/share/sqwebmail/libexec/authlib --with-authdaemonvar=/usr/local/share/sqwebmail/var/authdaemon --sysconfdir=/usr/local/share/sqwebmail --with-package=sqwebmail --with-version=4.0.7 --without-socks

It can take several minutes.

Then, we test the configuration:

[root@nsXXXX sqwebmail-4.0.7 ]# make configure-check
SqWebMail? CGI will be installed in /home/ovh/cgi-bin/
Images will be installed in /home/ovh/www/webmail
make[1]: Entre dans le répertoire `/home/ovh/src/sqwebmail-4.0.7/sqwebmail'
URL to the image directory is /webmail
make[1]: Quitte le répertoire `/home/ovh/src/sqwebmail-4.0.7/sqwebmail'

It looks ok, we can now launch the compilation:

[root@nsXXXX sqwebmail-4.0.7 ]# make

It may take several minutes.

Once the compilation is finished, check everything by entering the following:

[root@nsXXXX sqwebmail-4.0.7 ]# make check
[root@nsXXXX sqwebmail-4.0.7 ]# make install
[root@nsXXXX sqwebmail-4.0.7 ]# make install-configure
[root@nsXXXX sqwebmail-4.0.7 ]# chown vpopmail.vchkpw /home/ovh/cgi-bin/sqwebmail
[root@nsXXXX sqwebmail-4.0.7 ]# chmod 755 /home/ovh/cgi-bin/sqwebmail

Note: DO NOT FORGET TO LAUNCH SQWEBMAILD DAEMON to take the new version into account otherwise you will get the error:

''Internal Error
The webmail system is temporarily unavailable. An error occured in function write: Transport endpoint is not connected''

[root@nsXXXX sqwebmail-4.0.7 ]# /usr/local/share/sqwebmail/libexec/sqwebmaild.rc stop
[root@nsXXXX sqwebmail-4.0.7 ]# /usr/local/share/sqwebmail/libexec/sqwebmaild.rc start


We immediately test the access to webmail:
Connect on your pop account to test it and it is working :-)