UMPL for Xmailserver 2.11



Many Sysadmins have to solve the problem of giving customers the ability of creating, modifying and deleting email-users on their own. For such needs of virtual email hosting Xmailserver is a really good choice. This article covers how to install and configure the umpl-xmail webmail and admintool which helps to make the postmasters' live easier.
umpl-xmail is intented to be used on any Linux / BSD platform (designed for Linux/Apache). The code should also work on windows-servers but you will have to search for bugs on your own.
If you have questions about umpl-xmail feel free to join the umpl xmail mailinglist at or contact me at



After the installation you are able to use the following features (multilingual, at the moment: german, english, spanish, french, italian, dutch, slovenian, russian, polish, swedish, turkish, hungrian, arabic and greek):

Root-Interface ( http://umpl-xmail.tld/root/ ): Domain-Postmaster Interface ( http://umpl-xmail.tld/index.php ): User Interface ( http://umpl-xmail.tld/index.php ):

Software needed before starting

You have to install (if not done by now) several components before you start. Without these software umpl-xmail will NOT work.

These are:



Installing umpl xmail

Info This is the description for first-time installation.
If you want update an existing umpl-xmail installation you can go to the next point!

There are two different ways to install - I suggest using the perl-installer! If you can't use it ( because of having no root-access to the web-/ mysql-/ mailserver or having the services shared on diifferent machines ) you can also install and configure umpl xmail by hand.
The perl-installer and upgrade scripts will run on all ***x-like platforms and where successfully tested on the following systems:
- Linux: SuSE 7.3, 8.0, 8.2, 9.0 (perl 5.61 and 5.8), Debian Woody (perl 5.6 and 5.8).
- M$-Windows (Cygwin): XP, 2000 (perl 5.6, 5.61, 5.8.2).
If you have serious problems running it, please contact


Installing with perl-installer


Installing by hand

Please check: (Description for V2.7, but still the same to do for installing)



Updating umpl xmail

InfoThis is the description for updating an existing umpl-xmail installation.
There are two different ways to update - I suggest using the perl-installer! If you can't use it ( because of having no root-access to the web-/ mysqlserver or having the services shared on different machines ) you can also install and configure umpl xmail by hand.
Currently the perl-installer does only support updating from Version 2.9 or 2.10.


Automatic update using perl-installer (umpl_xmail_upgrade)


Updating by hand

Please check: (Description for V2.7, but still the same to do for updating)



umpl xmail is (c) 2001-2004 computing, released under Gnu Puplic License - This means you can use, share and modify this software, but it whould be usefull if you also contribute by developing and helping free software! e.g. by creating new language templates ;-)

If you want to say thanks to the authors you can do this by sending e.g. a picture postcard to: computing
Achim Schmidt
Haster Strasse 42
DE 49191 Belm
(remove _NOSPAM_)


Getting started

Info Beginning with Version 2.10 is bundled with umpl_xmail, which needs to know the correct MAIL_ROOT!
If you don't have Mail_ROOT at /var/MailRoot/ please change it inside '$doc_root/!

Info People that use umpl_xmail on Microsoft Windows environment (e.g. Roxen or IIS) please take an closer look to README.W32!

After having installed umpl-xmail you can start like that:

log in at /root using the $XM_user & $XM_passwrd values out of user_data.php.
create with pw test and a quota of 20 users and 100MB.
log in at /index.php using user: and pw test.
navigate to root-admin and you can create a user with pw test2 and a quota of 10 MB
now you can log in as user with pw test2 at /index.php
the non-root users can't access root-admin but use webmail, forwarding, etc.

Thats the system - hope you enjoy it!


Files / Directories

					# install-dir (to give during install)
/ 					# install-dir
	/ *.php				# PHP-Files Enduser-Interface
	/user_data.php			# data for Xmail & MySQL
	/root_*.php			# PHP-Files Postmaster-Admin

		/inc/ *			# include-Files for Postmaster & Enduser-Interface

		/img/ *			# images

	/root/ 				# Root-Admin
		/root/ *.php		# PHP-Dateien Root-Admin
		/root/class*		# Include-Files for Root-Interface

		/root/img/ * 		# images
	/tmp/*				# tmp files used by webmail (attachements)
	/autoreply/*			# text-files with users vacation-messages	

	/README				# text-documentation
	/INSTALL			# text-install-documentation
	/LICENSE			# text-gpl



This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
For more details see:



Thanks to those people for contributing / giving inspiration to this project:
Davide Libenzi father of xmailserver
Paul Heijman, SOGware code for server communication
Manuel Lemos code For MIME-Coding outgoing Mail & pop3 protocol
Charley Collins umpl-code for Autoreply
Theo Rosbag Autoreply-bash-script (c)2001 TPS Developement
Jens Wedler,, umpl libraries
the Horde project rocking function decode_mime_string()

Rolf Schwarzenberg spanish till 2.11
Roberto Pavesi, italian 2.11
Sasa Stupar slovenian 2.11
Frédéric Landry french 2.11
Tanguy Janssens, dutch 2.11
Csapó Balázs, 2.11
Ozgun AKSOY turkish 2.9
David Svensson swedish 2.9
Vladimir Miropolsk russian 2.9
Michal Borkowski, polish 2.11
Nabil Attar nabil.attar_AT_aws-syria.comarabic2.11
Theodoros Xanthopoulos,




2004, April 02 Achim Schmidt

[ Main Side ]   [ Screenshots ]   [ Download ]   [ umpl xmail @freshmeat ]