Install Z-Push ISPConfig 3

Posted on July 28, 2011 by admin

Z-push is an implementation of the ActiveSync protocol which is used ‘over-the-air’ for multi platform ActiveSync devices, including Windows Mobile, iPhone, Sony Ericsson and Nokia mobile devices.

Change web path : /var/www/clients/client5/web23/web/ part to your own settings…

cd /tmp
tar zxf z-push-1.3RC2.tar.gz
mv z-push /var/www/clients/client5/web23/web/

Edit the z-push/config.php file.

cd /var/www/clients/client5/web23/web/z-push
nano config.php

– Make sure that date_default_timezone_set (line 14) is set to your time zone.
– Set $BACKEND_PROVIDER to BackendIMAP (line 49).
– If you are having the same problem as I did, than change define(‘IMAP_DEFAULTFROM’, ”) (line 74) to define(‘IMAP_DEFAULTFROM’, ‘ ‘) (note the space between the ‘ ‘)

Remove the file backend/ics.php:

rm /var/www/clients/client5/web23/web/z-push/backend/ics.php

Make sure that directory z-push/state is writable for your webserver:

chmod 777 /var/www/clients/client5/web23/web/z-push/state

Create a .htaccess file:

nano .htaccess

And add this to it:

php_flag magic_quotes_gpc off
php_flag register_globals off
php_flag magic_quotes_runtime off
php_flag short_open_tag on

Add Alias /Microsoft-Server-ActiveSync /var/clients/client1/web1/web/z-push/index.php to your httpd.conf:

cd /etc/apache2/
nano httpd.conf

At the end of httpd.conf add:

Alias /Microsoft-Server-ActiveSync /var/www/clients/client5/web23/web/z-push/index.php

Restart Apache:

service httpd restart

Log in to ISPconfig3 and go the the tab Sites > Domain. Now select the website that you are installing z-push to, and set PHP to Mod-PHP. When done click Save.

Now go to, and with a bit of luck you will get a login popup screen. Use the email address and password from an IMAP user account. After this you will get an error:

This error is correct, as you are accessing the z-push by web browser. All you need to do now is set up your mobile phone, and you’ve got push working!
The URL of the server to use in your mobile phone will be You do not need to add z-push or Microsoft-Server-ActiveSync.

If you are having problems, than you can create a debug.txt in the root directory of z-push. The debug.txt will log all activity, and give you a lot of extra info to find the problem(s).

touch /var/www/clients/client5/web23/web/z-push/debug.txt
chmod 777 /var/www/clients/client5/web23/web/z-push/debug.txt