diff --git a/Installation.md b/Installation.md new file mode 100644 index 0000000..7e97a6c --- /dev/null +++ b/Installation.md @@ -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. + + + + + + +
Centos/RedHatopenSUSE/SLEsDebian
+ + +* * * +## 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```

Add the following lines:

```#EGroupware EPL repository```

```deb http://USERNAME:PASSWORD@download.egroupware.org/repos/stylite-epl/xUbuntu_16.04/ ./``` +| [2](#step-2)- ```apt update```

See [step 2](#step-2) to add repository key +| [3](#step-3)- ```apt install egroupware-epl```

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:
+*USERNAME*:*PASSWORD* are your given credentials for EPL version.
+ +*DISTRO_VERSION*: Means the version of distribution you're install EGroupware on it. You can find out the right version name from following list:
+ + +*** if you are not sure what distribution you're running, simply execute the following command:
+``` +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 + +* * *