egroupware/egroupware

EGroupware extends a classic groupware with an integrated CRM-system, a secure file-server and Collabora Online Office.

23.1.20241128 2024-11-28 10:16 UTC

Requires

• php: >=7.4,<=8.2
• ext-gd: *
• ext-json: *
• ext-mysqli: *
• ext-openssl: *
• ext-pdo: *
• ext-session: *
• ext-xml: *
• ext-xsl: *
• adldap2/adldap2: =4.0.4
• async-aws/s3: ^2.0
• bigbluebutton/bigbluebutton-api-php: ^2.0
• bower-asset/cropper: 2.3.*
• bower-asset/diff2html: ^2.7
• bower-asset/jquery: ^1.12.4
• defuse/php-encryption: ^2.4
• egroupware/activesync: 23.1.20241128
• egroupware/adodb-php: ^5.22.7.3
• egroupware/bookmarks: 23.1.20241128
• egroupware/collabora: 23.1.20241128
• egroupware/compress: ^2.3.0
• egroupware/crypt: ^2.8.0
• egroupware/crypt-blowfish: ^1.2.0
• egroupware/date: ^2.5.0
• egroupware/exception: ^2.1.0
• egroupware/hstream: ^1.7.0
• egroupware/http: ^2.2.0
• egroupware/icalendar: ^2.2.1
• egroupware/idna: ^1.2.0
• egroupware/imap-client: ^2.31.0
• egroupware/listheaders: ^1.3.0
• egroupware/mail: ^2.7.0
• egroupware/managesieve: ^1.1.0
• egroupware/mapi: ^1.1.0
• egroupware/mime: ^2.13.0
• egroupware/news_admin: 23.1.20241128
• egroupware/nls: ^2.3.0
• egroupware/openid: 23.1.20241128
• egroupware/projectmanager: 23.1.20241128
• egroupware/registration: 23.1.20241128
• egroupware/rocketchat: 23.1.20241128
• egroupware/secret: ^2.1.0
• egroupware/smallpart: 23.1.20241128
• egroupware/smtp: ^1.10.0
• egroupware/socket-client: ^2.2.0
• egroupware/status: 23.1.20241128
• egroupware/stream-filter: ^2.1.0
• egroupware/stream-wrapper: ^2.2.0
• egroupware/support: ^2.3.0
• egroupware/swoolepush: 23.1.20241128
• egroupware/text-diff: ^2.3.0
• egroupware/text-flowed: ^2.1.0
• egroupware/tracker: 23.1.20241128
• egroupware/translation: ^2.3.0
• egroupware/url: ^2.3.0
• egroupware/util: ^2.7.0
• egroupware/webdav: ^0.4.0
• egroupware/z-push-dev: 2.5.0.1
• giggsey/libphonenumber-for-php: ^8.12
• guzzlehttp/guzzle: ^7.4.1
• guzzlehttp/psr7: ^2.1.0
• jumbojett/openid-connect-php: ^0.9.10
• npm-asset/as-jqplot: 1.0.*
• npm-asset/gridster: 0.5.*
• oomphinc/composer-installers-extender: ^2.0.1
• pear/auth_sasl: *
• pear/log: *
• pear/pear: *
• pear/xml_feed_parser: ^1.0.5
• phpseclib/phpseclib: ^3.0.34
• pragmarx/google2fa-qrcode: ^1.0
• robrichards/xmlseclibs: ^3.1.1
• simplesamlphp/simplesamlphp: ^1.19.0
• simplesamlphp/twig-configurable-i18n: ~2.3.3
• tinymce/tinymce: ^5.10.8

Requires (Dev)

• phpunit/phpunit: ^9

Suggests

• ext-apcu: Used for in-memory caching
• ext-bz2: Used for compressing backups
• ext-ldap: Required to access LDAP or ActiveDirectory
• ext-mbstring: Used for charset conversation and Unicode support
• ext-mhash: Used for password hashing
• ext-opcache: Opcode cache to speed up PHP
• ext-tidy: Used for tidying up docx templates
• ext-zip: Used for backup and downloading of multiple files

GPL-2.0-or-later

• Ralf Becker
• Hadi Nategh
• Nathan Gray

• php
• javascript
• calendar
• webmail
• collaboration
• address-book
• project-management
• groupware
• caldav-server
• carddav-server

README

Default and prefered installation method for EGroupware is via your Linux package manager:

• Installation & Update instructions
• Distribution specific instructions

Every other method (including a developer installation by cloning the repo) is way more complicated AND does not include all features, as part's of EGroupware are running in different containers, eg. the push-server!

Installing EGroupware 23.1 via Docker for non-Linux environments or not supported Linux distros:

EGroupware 23.1 can be installed via Docker, in fact the DEB/RPM packages also does that. Instructions on how to run EGroupware in Docker are in our Wiki and in doc/docker subdirectory.

Installing EGroupware development version via Docker:

• this is the prefered developer installation, as it contains eg. a push-server container
• https://github.com/EGroupware/egroupware/tree/master/doc/docker/development

Deprecated EGroupware development installation:

• install composer.phar from https://getcomposer.org/download/
• for JavaScript dependencies and build install nodejs and npm
• optional: for minified CSS install grunt

apt/yum/zypper install nodejs
npm install -g grunt-cli

• install EGroupware and dependencies

cd /path/to/your/docroot
git clone https://github.com/EGroupware/egroupware.git # or [e-mail]:EGroupware/egroupware.git for ssh
cd egroupware
./install-cli.php

• install non-default EGroupware apps by cloning them into your egroupware directory eg.

cd /path/to/your/egroupware
git clone https://github.com/EGroupware/wiki.git

• continue installation at http://localhost/egroupware/setup/

Keeping EGroupware up to date or switch to release branch:

cd /path/to/your/egroupware
./install-cli.php [<change-channel>]
setup/setup-cli.php # will tell you if a schema-update is necessary

install-cli.php supports the following "channels":

• release: taged maintenance releases only eg. 19.1.20200701
• bugfix: release-branch incl. latest bugfixes eg. 20.1, if you are currently on 20.1.20200710
• <branch>: switch to given branch
• master: latest development for next release

To change the channel, call install-cli.php <channel-to-update-to>.

For further instalation instructions see our wiki.