egroupware_official/README.md

50 lines
2.1 KiB
Markdown
Raw Normal View History

2017-11-15 15:45:29 +01:00
# EGroupware 17.1
2016-06-04 09:13:09 +02:00
| Branch | Status | Composer |
| ------ | ------ | -------- |
2017-11-15 15:45:29 +01:00
| 17.1 | [![Build Status](https://travis-ci.org/EGroupware/egroupware.svg?branch=17.1)](https://travis-ci.org/EGroupware/egroupware) | [![Dependency Status](https://www.versioneye.com/user/projects/57527e0c7757a0003bd4aecb/badge.svg?style=flat)](https://www.versioneye.com/user/projects/57527deb7757a00041b3a25e) |
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
2017-11-15 15:45:29 +01:00
### Installing EGroupware 17.1 from Github:
2017-06-06 12:02:51 +02:00
* install composer.phar from https://getcomposer.org/download/
* 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
git clone -b 17.1 https://github.com/EGroupware/egroupware.git # or git@github.com:EGroupware/egroupware.git for ssh
cd egroupware
./install-cli.php
```
* install further EGroupware apps by cloning them into your egroupware directory eg.
```
cd /path/to/your/egroupware
git clone -b 17.1 https://github.com/EGroupware/registration.git
```
2017-06-06 12:02:51 +02:00
* continue installation at http://localhost/egroupware/setup/
2017-11-15 15:45:29 +01:00
### Keeping EGroupware up to date:
```
2019-02-23 13:29:28 +01:00
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
2019-02-23 13:29:28 +01:00
- \<branch\>: switch to given branch
- master: latest development for next release
To change the channel, call install-cli.php <channel-to-update-to>.
### Switching a git installation from 16.1 to 17.1:
(Only necessary for 16.1, 17.1+ use: install-cli.php <new-channel>
2017-11-15 15:45:29 +01:00
```
for d in . * activesync/vendor/z-push/z-push api/src/Db/ADOdb ; do [ -d $d/.git ] && (echo $d; cd $d; git checkout 17.1); done
```
For further instalation instructions see our wiki.