View source for Z-Push

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

{| class="vwiki-note"
|-
| '''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
#* eg <code> wget http://download.berlios.de/z-push/z-push-1.5.4-707.tar.gz </code>
# Extract the download
#* eg <code> tar -zvf z-push-1.5.4-707.tar.gz </code>
# Copy the software to your web root
#* <code> cp -r z-push-1.5.4-707 /var/www/z-push </code>
# Allow write access to the <code> state </code> folder
#* EG <code> chgrp www-data /var/www/z-push/state </code>
#* EG <code> chmod g+w /var/www/z-push/state </code>
# Edit <code> config.php </code> settings for
## Timezone (set to your local timezone)
##* EG <code> date_default_timezone_set("Europe/London"); </code>
## Provisioning (security - needs to be relaxed for older mobile devices)
##* EG <code> define('LOOSE_PROVISIONING', true); </code>
## Backend provider
##* EG <code> $BACKEND_PROVIDER = "BackendZimbra"; </code>
## and append the following Zimbra Backend settings
##* <code> // ************************ </code>
##* <code> //  BackendZimbra settings </code>
##* <code> // ************************ </code>
##* <code> define('ZIMBRA_URL', 'https://NameOfYourDoman.com');	//Please do not put a trailing forward slash at the end of the url </code>
##* <code> define('ZIMBRA_USER_DIR', 'zimbra'); </code>
##* <code> define('ZIMBRA_SYNC_CONTACT_PICTURES', true); </code>
##* <code> define('ZIMBRA_VIRTUAL_CONTACTS',true); </code>
##* <code> define('ZIMBRA_VIRTUAL_APPOINTMENTS',true); </code>
##* <code> define('ZIMBRA_VIRTUAL_TASKS',true); </code>
##* <code> define('ZIMBRA_IGNORE_EMAILED_CONTACTS',true); </code>
##* <code> define('ZIMBRA_HTML',true); </code>
##* <code> define('ZIMBRA_ENFORCE_VALID_EMAIL',true); </code>
##* <code> define('ZIMBRA_SMART_FOLDERS',true); </code>
##* <code> define('ZIMBRA_DEBUG',true);</code>
# Create file for debug to go to
#* <code> touch /var/www/z-push/debug.txt </code>
#* <code> chmod 777 /var/www/z-push/debug.txt </code>
# Install PHP cURL
#* <code> apt-get install php5-curl </code>
# Download <code> z-RTF.php </code> to the include directory
#* EG <code> wget -O include/z_RTF.php http://svn.berlios.de/viewvc/z-push/branches/as12/include/z_RTF.php?revision=249 </code>
# Add an alias to the Apache site config (eg <code> /etc/apache2/sites-enabled/000-default </code>), and all php config in <code> .htaccess </code>
#* <code> /Microsoft-Server-ActiveSync /var/www/z-push/index.php </code>
#* <code> <Directory /var/www/z-push> </code>
#* <code>       AllowOverride All </code>
#* <code> </Directory> </code>
# Create a <code> .htaccess </code> in root of z-push with the following entries
#* <code> php_flag magic_quotes_gpc off </code>
#* <code> php_flag register_globals off </code>
#* <code> php_flag magic_quotes_runtime off </code>
#* <code> php_flag short_open_tag on </code>
# Download the latest Zimbra Backend release from http://downloads.sourceforge.net/project/zimbrabackend and untar to <code> backend </code> folder

[[Category:Zimbra]]
[[Category:Z-Push]]