egroupware

# EGroupware

| Tools | Usage |
| ----- | ----- |
| <img src="https://browserstack.wpenginepowered.com/wp-content/themes/browserstack/img/bstack-logo-global.svg" width="110" alt="BrowserStack" /> | manual testing with unusual browser versions or platforms |

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

* [Installation & Update instructions](https://github.com/EGroupware/egroupware/wiki/Installation-using-egroupware-docker-RPM-DEB-package)
* [Distribution specific instructions](https://github.com/EGroupware/egroupware/wiki/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 26 via Docker for non-Linux environments or not supported Linux distros:
EGroupware 26 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](https://github.com/EGroupware/egroupware/wiki/Docker-compose-installation) and in [doc/docker](https://github.com/EGroupware/egroupware/tree/26/doc/docker) subdirectory.

### Installing EGroupware development version via Docker:
* this is the preferred 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 and CSS dependencies and build install nodejs and npm
```
apt/yum/zypper install nodejs npm
```
* install EGroupware and dependencies
```
cd /path/to/your/docroot
git clone https://github.com/EGroupware/egroupware.git # or [email protected]: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: tagged maintenance releases only eg. 26.8.20260804
- bugfix:  release-branch incl. latest bugfixes eg. 26, if you are currently on 26.8.20260804
- \<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 installation instructions see our wiki.