Created Debian Installation (markdown)

Hadi Nategh 2018-02-13 17:17:32 +01:00
parent 2dcb527896
commit bcf72d38ce

160
Debian-Installation.md Normal file

@ -0,0 +1,160 @@
> [Wiki](Home) ▸ [Installation](installation) ▸ **EGroupware Debian Installation**
Debian Installation
=======
This installation instruction is based on Debian 9. If you wish to install
EGroupware on other environments please select relevant instruction from the
below list.
<table>
<tr>
<td><a href="https://github.com/EGroupware/egroupware/wiki/Centos-redHat-Installation"><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="https://github.com/EGroupware/egroupware/wiki/openSUSE-SLEs-Installation"><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="https://github.com/EGroupware/egroupware/wiki/Debian-Installation"><img src="https://software.opensuse.org/assets/download/ubuntu-1275234a5d802bea3ebcf789a50c9589.png"/>Ubuntu</a></td>
</tr>
</table>
* * *
**IMPORTANT:** ``EGroupware installation consists of two versions; EPL Version and Community Version. Technically, the only installation difference 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/Debian_9.0/ ./```
| [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
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
```
For EPL Version:
```
#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/Debian_9.0/ ./
```
OR
For Community Version:
```
#EGroupware Community repository
deb http://download.egroupware.org/repositories/server:/eGroupWare/DISTRO_NAME/ ./
```
Example:
```
#EGroupware Community repository
deb http://download.opensuse.org/repositories/server:/eGroupWare/Debian_9.0/ ./
```
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>
<table>
<tr ><td colspan="all">DISTRO_VERSION</td></tr>
<tr>
<td>Debian_9.0</td>
<td>Debian_8.0</td>
<td>Debian_7.0</td>
</tr>
</table>
*** 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/Debian_9.0/Release.key -O Release.key | apt-key add -
```
if you're not running Debian_9.0 please see [DISTRO_VERSION](https://software.opensuse.org/download.html?project=server%3AeGroupWare&package=egroupware-epl) to find out your distro specific url.
```
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 field empty,
a randomized password gets generated which you can get access to it via egroupware-epl.log
file after installation is completed.``
<table>
<tr>
<td><img src="https://raw.githubusercontent.com/wiki/EGroupware/egroupware/pics/installation/figure1.png"/></td>
<td><img src="https://raw.githubusercontent.com/wiki/EGroupware/egroupware/pics/installation/figure2.png"/></td>
</tr>
<tr>
<td><img src="https://raw.githubusercontent.com/wiki/EGroupware/egroupware/pics/installation/figure3.png"/></td>
<td><img src="https://raw.githubusercontent.com/wiki/EGroupware/egroupware/pics/installation/figure4.png"/></td>
</tr>
<tr>
<td><img src="https://raw.githubusercontent.com/wiki/EGroupware/egroupware/pics/installation/figure5.png"/></td>
<td><img src="https://raw.githubusercontent.com/wiki/EGroupware/egroupware/pics/installation/figure6.png"/></td>
</tr>
</table>
#### 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://github.com/EGroupware/egroupware/wiki/Basic-PHP-%26amp%3B-MySQL-Adjustments) in order to get the best performance.
#### Step 5:
Congratulations!!!
_back to [Content](#content)_
* * *
##### End of Document
* * *