Commit ef32e01b4c365858582ba1c400bfba8b1558fd8d
Exists in
master
and in
4 other branches
Merge branch 'master' of github.com:gitlabhq/gitlabhq
Showing
1 changed file
with
27 additions
and
22 deletions
Show diff stats
doc/installation.md
| 1 | ## Platform requirements: | 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 | 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. | 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 | It should work on: | 12 | It should work on: |
| 13 | 13 | ||
| 14 | - Fedora | 14 | - Fedora |
| 15 | - CentOs | 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 | - FreeBSD | 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 | ## This installation guide created for Debian/Ubuntu and properly tested. | 25 | ## This installation guide created for Debian/Ubuntu and properly tested. |
| 27 | 26 | ||
| 28 | The installation consists of 6 steps: | 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 | > First 3 steps can be easily skipped with simply install script: | 45 | > First 3 steps can be easily skipped with simply install script: |
| @@ -56,6 +61,9 @@ The installation consists of 6 steps: | @@ -56,6 +61,9 @@ The installation consists of 6 steps: | ||
| 56 | sudo apt-get upgrade | 61 | sudo apt-get upgrade |
| 57 | 62 | ||
| 58 | 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 | 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 | # 2. Install ruby | 68 | # 2. Install ruby |
| 61 | 69 | ||
| @@ -79,8 +87,6 @@ Create user for git: | @@ -79,8 +87,6 @@ Create user for git: | ||
| 79 | --home /home/git \ | 87 | --home /home/git \ |
| 80 | git | 88 | git |
| 81 | 89 | ||
| 82 | - | ||
| 83 | - | ||
| 84 | Create user for gitlab: | 90 | Create user for gitlab: |
| 85 | 91 | ||
| 86 | # ubuntu/debian | 92 | # ubuntu/debian |
| @@ -122,8 +128,7 @@ Permissions: | @@ -122,8 +128,7 @@ Permissions: | ||
| 122 | # if succeed you can remove it | 128 | # if succeed you can remove it |
| 123 | sudo rm -rf /tmp/gitolite-admin | 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 | # 4. Install gitlab and configuration. Check status configuration. | 133 | # 4. Install gitlab and configuration. Check status configuration. |
| 129 | 134 | ||
| @@ -196,8 +201,8 @@ Application can be started with next command: | @@ -196,8 +201,8 @@ Application can be started with next command: | ||
| 196 | ./resque.sh | 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 | # Nginx && Unicorn | 207 | # Nginx && Unicorn |
| 203 | 208 |