egroupware/README.md

54 lines
3.2 KiB
Markdown
Raw Normal View History

2016-05-12 18:08:44 +02:00
# EGroupware
| Branch | Status | Tools | Usage |
| ------ | ------ | ----- | ----- |
2020-02-04 09:07:29 +01:00
| master | [![Build Status](https://travis-ci.org/EGroupware/egroupware.svg?branch=master)](https://travis-ci.org/EGroupware/egroupware) | <img src="https://travis-ci.com/images/logos/TravisCI-Full-Color.png" width="108" alt="Travis CI"/> | runs unit-tests after each commit |
2020-02-04 09:35:23 +01:00
| 19.1 | [![Build Status](https://travis-ci.org/EGroupware/egroupware.svg?branch=19.1)](https://travis-ci.org/EGroupware/egroupware) | [![Scrutinizer CI](https://scrutinizer-ci.com/images/logo.png)](https://scrutinizer-ci.com/g/EGroupware/egroupware/) scrutinizer | runs static analysis on our codebase |
| 17.1 | [![Build Status](https://travis-ci.org/EGroupware/egroupware.svg?branch=17.1)](https://travis-ci.org/EGroupware/egroupware) | <img src="https://p14.zdusercontent.com/attachment/1015988/zGiHOaPFC0e9nG4PJWXZH1Ibe?token=eyJhbGciOiJkaXIiLCJlbmMiOiJBMTI4Q0JDLUhTMjU2In0..i_vov1AU7X1qzPu3nYPL-Q.tdgDtQMrCCHEACS4aXPcYTKf8BeQUVGohG0-UFeEnJwC_d4KvmSz4EaV2NpQmQ9B-m-3Sj9EyfxNVW6XSOksFBd-QZz2CLu5il0ko2KdvC4YjEGFQkmPJOAPfVQfwXcZkg08eaX-4aluvvwBQQv5oXRbCVVX-lMtYE_1OPBTYPRZoBEWEnIlCGix05vC82EOvqzQ2Ht9lGpwfFLMfawIT5l-sCi5vAluKBJKR2pkduFqq3DD_E1Y2YqPA3utD3zDfcU5Zb4Qqd1pfkES3_9L3CnluMmIKG6bY5aFDyLPPUE.KENm6nkdraKqs2JzQIwHpQ" width="110" alt="BrowserStack"/> | manual testing with unusual browser versions or platforms |
2017-11-15 16:53:44 +01:00
2016-05-12 18:08:44 +02:00
### Default and prefered installation method for EGroupware is via your package manager:
https://software.opensuse.org/download.html?project=server%3AeGroupWare&package=egroupware-epl
### Installing EGroupware 19.1+ via Docker:
2019-07-19 10:16:43 +02:00
EGroupware 19.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 [doc/docker](https://github.com/EGroupware/egroupware/tree/master/doc/docker) subdirectory.
2017-11-15 16:53:44 +01:00
### Installing EGroupware 17.1 from github:
[switch to 17.1 branch](https://github.com/EGroupware/egroupware/tree/17.1) and follow instructions there
2016-06-27 17:03:57 +02:00
### Installing EGroupware development version:
2017-06-06 12:02:51 +02:00
* install composer.phar from https://getcomposer.org/download/
2019-02-23 13:31:45 +01:00
* optional: for minified JavaScript and CSS install nodejs and grunt
```
apt/yum/zypper install nodejs
npm install -g grunt-cli
```
* install EGroupware and dependencies
```
cd /path/to/your/docroot
2019-02-24 11:27:38 +01:00
git clone https://github.com/EGroupware/egroupware.git # or git@github.com:EGroupware/egroupware.git for ssh
2019-02-23 13:31:45 +01:00
cd egroupware
./install-cli.php
```
* install non-default EGroupware apps by cloning them into your egroupware directory eg.
2019-02-23 13:31:45 +01:00
```
cd /path/to/your/egroupware
git clone https://github.com/EGroupware/wiki.git
2019-02-23 13:31:45 +01:00
```
2017-06-06 12:02:51 +02:00
* continue installation at http://localhost/egroupware/setup/
2019-02-23 13:31:45 +01:00
### 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. 17.1.20190222
- bugfix: release-branch incl. latest bugfixes eg. 17.1, if you are currently on 17.1.20190222
- \<branch\>: switch to given branch
- master: latest development for next release
2019-02-23 13:33:25 +01:00
To change the channel, call ```install-cli.php <channel-to-update-to>```.
2019-02-23 13:31:45 +01:00
For further instalation instructions see our wiki.