Z-Push
Jump to navigation
Jump to search
Z-Push installation instructions - These instructions assume that you already have a working Apache web server with PHP running, on which to run the Z-Push and Zimbra Backend PHP scripts.
Z-Push provides the ActiveSync functionality for your mobile device, the Zimbra Backend interfaces this with the Zimbra server using its SOAP API.
Z-Push is constantly being updated, and the main forum thread in which to keep track of updates and bugfixes is here - http://www.zimbra.com/forums/mobility/26536-z-push-zimbra-backend-push-email-contacts-appointments-tasks.html
This information on this page details Z-Push v1 which has now been superseded |
Z-Push v1 is only capable of syncing raw text content (not HTML formatted emails for example). There is an unsupported (but completely functional) branch of Z-Push v1 that handles HTML format content, see Z-Push with Zimbra and HTML Support. |
Z-Push v2, which fully supports HTML email, has now been released. See Z-Push v2 with Zimbra for install instructions. |
- Download the latest version from https://developer.berlios.de/project/filelist.php?group_id=8963
- Extract the download
- eg
tar -zvf z-push-1.5.4-707.tar.gz
- eg
- Copy the software to your web root
cp -r z-push-1.5.4-707 /var/www/z-push
- Allow write access to the
state
folder- EG
chgrp www-data /var/www/z-push/state
- EG
chmod g+w /var/www/z-push/state
- EG
- Edit
config.php
settings for- Timezone (set to your local timezone)
- EG
date_default_timezone_set("Europe/London");
- EG
- Provisioning (security - needs to be relaxed for older mobile devices)
- EG
define('LOOSE_PROVISIONING', true);
- EG
- Backend provider
- EG
$BACKEND_PROVIDER = "BackendZimbra";
- EG
- and append the following Zimbra Backend settings
// ************************
// BackendZimbra settings
// ************************
define('ZIMBRA_URL', 'https://NameOfYourDoman.com'); //Please do not put a trailing forward slash at the end of the url
define('ZIMBRA_USER_DIR', 'zimbra');
define('ZIMBRA_SYNC_CONTACT_PICTURES', true);
define('ZIMBRA_VIRTUAL_CONTACTS',true);
define('ZIMBRA_VIRTUAL_APPOINTMENTS',true);
define('ZIMBRA_VIRTUAL_TASKS',true);
define('ZIMBRA_IGNORE_EMAILED_CONTACTS',true);
define('ZIMBRA_HTML',true);
define('ZIMBRA_ENFORCE_VALID_EMAIL',true);
define('ZIMBRA_SMART_FOLDERS',true);
define('ZIMBRA_DEBUG',true);
- Timezone (set to your local timezone)
- Create file for debug to go to
touch /var/www/z-push/debug.txt
chmod 777 /var/www/z-push/debug.txt
- Install PHP cURL
apt-get install php5-curl
- Download
z-RTF.php
to the include directory- EG
wget -O include/z_RTF.php http://svn.berlios.de/viewvc/z-push/branches/as12/include/z_RTF.php?revision=249
- EG
- Add an alias to the Apache site config (eg
/etc/apache2/sites-enabled/000-default
), and all php config in.htaccess
/Microsoft-Server-ActiveSync /var/www/z-push/index.php
<Directory /var/www/z-push>
AllowOverride All
</Directory>
- Create a
.htaccess
in root of z-push with the following entriesphp_flag magic_quotes_gpc off
php_flag register_globals off
php_flag magic_quotes_runtime off
php_flag short_open_tag on
- Download the latest Zimbra Backend release from http://downloads.sourceforge.net/project/zimbrabackend and untar to
backend
folder