Commit d706805c003fd845f64ea1c78c03efd687da7f38
1 parent
bae4efa7
Exists in
master
and in
4 other branches
Added info on MySQL; Fixed formatting and language.
Showing
1 changed file
with
27 additions
and
22 deletions
Show diff stats
doc/installation.md
| 1 | 1 | ## Platform requirements: |
| 2 | 2 | |
| 3 | -**The project is designed for the Linux operating system. ** | |
| 3 | +**The project is designed for the Linux operating system.** | |
| 4 | 4 | |
| 5 | 5 | It may work on FreeBSD and Mac OS, but we don't test our application for these systems and can't guarantee stability and full functionality. |
| 6 | 6 | |
| 7 | -We officially support next Linux Distributions: | |
| 7 | +We officially support (recent versions of) these Linux distributions: | |
| 8 | 8 | |
| 9 | -- Ubuntu | |
| 10 | -- Debian | |
| 9 | +- Ubuntu Linux | |
| 10 | +- Debian/GNU Linux | |
| 11 | 11 | |
| 12 | 12 | It should work on: |
| 13 | 13 | |
| 14 | 14 | - Fedora |
| 15 | 15 | - CentOs |
| 16 | -- Red Hat | |
| 16 | +- RedHat | |
| 17 | 17 | |
| 18 | -It can work on: | |
| 18 | +You might have some luck using these, but no guarantees: | |
| 19 | 19 | |
| 20 | - - Mac Os | |
| 20 | + - MacOS X | |
| 21 | 21 | - FreeBSD |
| 22 | 22 | |
| 23 | -It 100% **wont** work on Windows | |
| 24 | - | |
| 23 | +Gitlab does **not** run on Windows and we have no plans of making Gitlab compatible. | |
| 25 | 24 | |
| 26 | 25 | ## This installation guide created for Debian/Ubuntu and properly tested. |
| 27 | 26 | |
| 28 | 27 | The installation consists of 6 steps: |
| 29 | 28 | |
| 30 | -1. install packeges. | |
| 31 | -2. install ruby | |
| 32 | -3. install gitolite | |
| 33 | -4. install gitlab and configuration. Check status configuration. | |
| 34 | -5. server up. | |
| 35 | -6. run resque process (for processing queue). | |
| 29 | +1. Install packages / dependencies | |
| 30 | +2. Install ruby | |
| 31 | +3. Install gitolite | |
| 32 | +4. Install and configure Gitlab. | |
| 33 | +5. Start the web front-end | |
| 34 | +6. Start a Resque worker (for background processing) | |
| 35 | + | |
| 36 | +### IMPORTANT | |
| 37 | + | |
| 38 | +Please make sure you have followed all the steps below before posting to the mailinglist with installation and configuration questions. | |
| 39 | + | |
| 40 | +Only create a Github Issue if you want a specific part of this installation guide updated. | |
| 36 | 41 | |
| 37 | -** Before submit an installation issue - please check if you followed all steps ** | |
| 42 | +Also read the [Read this before you submit an issue](https://github.com/gitlabhq/gitlabhq/wiki/Read-this-before-you-submit-an-issue) wiki page. | |
| 38 | 43 | |
| 39 | 44 | > - - - |
| 40 | 45 | > First 3 steps can be easily skipped with simply install script: |
| ... | ... | @@ -56,6 +61,9 @@ The installation consists of 6 steps: |
| 56 | 61 | sudo apt-get upgrade |
| 57 | 62 | |
| 58 | 63 | sudo apt-get install -y git-core wget curl gcc checkinstall libxml2-dev libxslt-dev sqlite3 libsqlite3-dev libcurl4-openssl-dev libreadline-dev libc6-dev libssl-dev libmysql++-dev make build-essential zlib1g-dev libicu-dev redis-server openssh-server git-core python-dev python-pip sendmail |
| 64 | + | |
| 65 | + # If you want to use MySQL: | |
| 66 | + sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev | |
| 59 | 67 | |
| 60 | 68 | # 2. Install ruby |
| 61 | 69 | |
| ... | ... | @@ -79,8 +87,6 @@ Create user for git: |
| 79 | 87 | --home /home/git \ |
| 80 | 88 | git |
| 81 | 89 | |
| 82 | - | |
| 83 | - | |
| 84 | 90 | Create user for gitlab: |
| 85 | 91 | |
| 86 | 92 | # ubuntu/debian |
| ... | ... | @@ -122,8 +128,7 @@ Permissions: |
| 122 | 128 | # if succeed you can remove it |
| 123 | 129 | sudo rm -rf /tmp/gitolite-admin |
| 124 | 130 | |
| 125 | -** IMPORTANT! If you cant clone `gitolite-admin` repository - DONT PROCEED INSTALLATION** | |
| 126 | - | |
| 131 | +**IMPORTANT! If you cant clone `gitolite-admin` repository - DONT PROCEED INSTALLATION** | |
| 127 | 132 | |
| 128 | 133 | # 4. Install gitlab and configuration. Check status configuration. |
| 129 | 134 | |
| ... | ... | @@ -196,8 +201,8 @@ Application can be started with next command: |
| 196 | 201 | ./resque.sh |
| 197 | 202 | |
| 198 | 203 | |
| 199 | -** Ok - we have a working application now. ** | |
| 200 | -** But keep going - there are some thing that should be done ** | |
| 204 | +**Ok - we have a working application now. ** | |
| 205 | +**But keep going - there are some thing that should be done ** | |
| 201 | 206 | |
| 202 | 207 | # Nginx && Unicorn |
| 203 | 208 | ... | ... |