egroupware/egroupware

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

23.1.20240304 2024-03-04 08:17 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.20240304
• egroupware/adodb-php: ^5.20.11
• egroupware/bookmarks: 23.1.20240304
• egroupware/collabora: 23.1.20240304
• 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.20240304
• egroupware/nls: ^2.3.0
• egroupware/openid: 23.1.20240304
• egroupware/projectmanager: 23.1.20240304
• egroupware/registration: 23.1.20240304
• egroupware/rocketchat: 23.1.20240304
• egroupware/secret: ^2.1.0
• egroupware/smallpart: 23.1.20240304
• egroupware/smtp: ^1.10.0
• egroupware/socket-client: ^2.2.0
• egroupware/status: 23.1.20240304
• egroupware/stream-filter: ^2.1.0
• egroupware/stream-wrapper: ^2.2.0
• egroupware/support: ^2.3.0
• egroupware/swoolepush: 23.1.20240304
• egroupware/text-diff: ^2.3.0
• egroupware/text-flowed: ^2.1.0
• egroupware/tracker: 23.1.20240304
• 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

Tools	Usage
	runs unit-tests after each commit
scrutinizer	runs static analysis on our codebase
	manual testing with unusual browser versions or platforms

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 21.1 via Docker for non-Linux environments or not supported Linux distros:

EGroupware 21.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.