extern/egroupware
1
0
Fork 1
mirror of https://github.com/EGroupware/egroupware.git synced 2024-11-27 18:33:21 +01:00
Code Issues Packages Projects Releases Wiki Activity

Created Installation (markdown)

Hadi Nategh 2018-02-13 15:34:37 +01:00
parent 653b9497a1
commit 18b6a65638
1 changed files with 141 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

141
Installation.md Normal file

@ -0,0 +1,141 @@
> [Wiki](Home) ▸ [Installation](installation) ▸ **EGroupware Installation**
Installation
=======
This installation instruction is based on Ubuntu 16.04 (`highly recommended`), if you wish to install
EGroupware on other environments please select relevant instruction from the
below list.
<table>
<tr>
<td><a href="http://github.com/EGroupware/wiki/#1"><img src="https://software.opensuse.org/assets/download/centos-de865c285c8e1567761ee0feadbf4778.png"/>Centos/RedHat<img src="https://software.opensuse.org/assets/download/rhel-4f3565f8f0c66c2a555caf5c5fc3b287.png"/></a></td>
<td><a href="http://github.com/EGroupware/wiki/#1"><img src="https://software.opensuse.org/assets/download/opensuse-ea5fec454e9f4ca53ea7276f48905243.png"/>openSUSE/SLEs<img src="https://software.opensuse.org/assets/download/sle-a04c87206b6b247faebf37f846f8781d.png"/></a></td>
<td><a href="http://github.com/EGroupware/wiki/#1"><img src="https://software.opensuse.org/assets/download/debian-7c7747407454caca1c5ab01fed35581d.png"/>Debian</a></td>
</tr>
</table>
* * *
## Ubuntu
**IMPORTANT:** ``EGroupware installation consists of two versions; EPL Version and Community Version. Technically, the only difference of installing between EPL and Community version is their repository URLs. Please make sure you will follow relevant difference parts of your desired version.``
Are you an expert admin? then follow the Express Instruction below, otherwise
please follow [step-by-step](#step-by-step-installation) installation.
| Express Instruction
|---------------------------------
| [1](#step-1)- ``` vi /etc/apt/source.list.d/egroupware-epl.sources.list``` <br></br>Add the following lines:<br></br>```#EGroupware EPL repository```<br></br>```deb http://USERNAME:PASSWORD@download.egroupware.org/repos/stylite-epl/xUbuntu_16.04/ ./```
| [2](#step-2)- ```apt update```<br></br> See [step 2](#step-2) to add repository key
| [3](#step-3)- ```apt install egroupware-epl```<br></br>follow the installation instruction
| [4](#step-4)- ```less /root/egroupware-epl.log```
| [5](#step-5)- ***Congratulations!!!*** You may login to your EGroupware instance
******
### STEP-BY-STEP INSTALLATION
Whether you're on Ubuntu or Debian you can quickly install EGroupware by following below steps:
#### step 1:
Add EGroupware repository into source lists in order to fetch EGroupware's packages.
```
vi /etc/apt/source.list.d/egroupware-epl.sources.list
```
There's two different repository; one is for EPL version and other one is for Community version, please add relevant repository based on the version you would like to install.
EPL Repository:
```
#EGroupware EPL repository
deb http://USERNAME:PASSWORD@download.egroupware.org/repos/stylite-epl/DISTRO_NAME/ ./
```
Example:
```
#EGroupware EPL repository
deb http://peter:secret@download.egroupware.org/repos/stylite-epl/xUbuntu_16.04/ ./
```
Community Repository:
```
#EGroupware Community repository
deb http://download.egroupware.org/repos/stylite-epl/DISTRO_NAME/ ./
```
Example:
```
#EGroupware Community repository
deb http://download.egroupware.org/repos/stylite-epl/xUbuntu_16.04/ ./
```
Replace the following variables used in above urls with your own values:</br>
*USERNAME*:*PASSWORD* are your given credentials for EPL version.</br>
*DISTRO_VERSION*: Means the version of distribution you're install EGroupware on it. You can find out the right version name from following list:</br>
*** if you are not sure what distribution you're running, simply execute the following command:</br>
```
cat /etc/os-release
```
#### Step 2:
After adding EGroupware's repository into sources list, we need to update to fetch packages. Before doing the update we are going to make sure that we have the repository key
added.
EGroupware EPL Version:
```
wget -O - http://USER:PASSWORD@download.egroupware.org/build%40egroupware.org | apt-key add -
```
OR
EGroupware Community Version:
```
wget -nv https://download.opensuse.org/repositories/server:eGroupWare/xUbuntu_16.04/Release.key -O Release.key | apt-key add -
```
```
apt update
```
#### Step 3:
Now it's time to install egroupware-epl packages. Depends on the webserver you
would like to use with EGroupware, you may install a webserver among the egroupware-epl
packages, by default Apache will be installed.
``` apt install egroupware-epl ```
e.g. for nginx installation:
``` apt install nginx egroupware-epl```
follow the installation instruction as shown in following figures:
``In the following instructions whenever you leave a password fields empty,
a randomized password gets generated which you can get access to it via egroupware-epl.log
file after installation is completed.``
![alt text]("https://www.github.org/EGroupware/wiki/figure1.png")
![alt text]("https://www.github.org/EGroupware/wiki/figure2.png")
![alt text]("https://www.github.org/EGroupware/wiki/figure3.png")
![alt text]("https://www.github.org/EGroupware/wiki/figure4.png")
![alt text]("https://www.github.org/EGroupware/wiki/figure5.png")
![alt text]("https://www.github.org/EGroupware/wiki/figure6.png")
#### Step 4:
You may check egroupware-epl.log file in order to check if everything went well during the installation plus you can get access to your egroupware credentials.
```
less /root/egroupware-epl.log
```
from this moment on you may get logged in to your EGroupware instance via the mentioned
url in egroupware-epl.log. Although, before doing that we highly do recommend to take couple of more steps to adjust couple of settings for [PHP and MyQL](https://www.github.org/EGroupware/wiki/configure_php_and_mysql) in order to get the best performance.
#### Step 5:
Congratulations!!!
_back to [Content](#content)_
* * *
##### End of Document
* * *