Z-Push
Jump to navigation
Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
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