summaryrefslogtreecommitdiff
path: root/doc/installation.md
diff options
context:
space:
mode:
authorAriejan de Vroom <ariejan@ariejan.net>2012-03-28 10:07:24 +0300
committerAriejan de Vroom <ariejan@ariejan.net>2012-03-28 10:07:24 +0300
commitd706805c003fd845f64ea1c78c03efd687da7f38 (patch)
treed02eeb2628850e184aa62f4db8ca0724ad755e45 /doc/installation.md
parentbae4efa7cf1ebedc0f74627da599a4cd5e93fd7f (diff)
downloadgitlab-ce-d706805c003fd845f64ea1c78c03efd687da7f38.tar.gz
Added info on MySQL; Fixed formatting and language.
Diffstat (limited to 'doc/installation.md')
-rw-r--r--doc/installation.md49
1 files changed, 27 insertions, 22 deletions
diff --git a/doc/installation.md b/doc/installation.md
index c2b11b2b516..7ce113b6502 100644
--- a/doc/installation.md
+++ b/doc/installation.md
@@ -1,40 +1,45 @@
## Platform requirements:
-**The project is designed for the Linux operating system. **
+**The project is designed for the Linux operating system.**
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.
-We officially support next Linux Distributions:
+We officially support (recent versions of) these Linux distributions:
-- Ubuntu
-- Debian
+- Ubuntu Linux
+- Debian/GNU Linux
It should work on:
- Fedora
- CentOs
-- Red Hat
+- RedHat
-It can work on:
+You might have some luck using these, but no guarantees:
- - Mac Os
+ - MacOS X
- FreeBSD
-It 100% **wont** work on Windows
-
+Gitlab does **not** run on Windows and we have no plans of making Gitlab compatible.
## This installation guide created for Debian/Ubuntu and properly tested.
The installation consists of 6 steps:
-1. install packeges.
-2. install ruby
-3. install gitolite
-4. install gitlab and configuration. Check status configuration.
-5. server up.
-6. run resque process (for processing queue).
+1. Install packages / dependencies
+2. Install ruby
+3. Install gitolite
+4. Install and configure Gitlab.
+5. Start the web front-end
+6. Start a Resque worker (for background processing)
+
+### IMPORTANT
+
+Please make sure you have followed all the steps below before posting to the mailinglist with installation and configuration questions.
+
+Only create a Github Issue if you want a specific part of this installation guide updated.
-** Before submit an installation issue - please check if you followed all steps **
+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.
> - - -
> First 3 steps can be easily skipped with simply install script:
@@ -56,6 +61,9 @@ The installation consists of 6 steps:
sudo apt-get upgrade
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
+
+ # If you want to use MySQL:
+ sudo apt-get install -y mysql-server mysql-client libmysqlclient-dev
# 2. Install ruby
@@ -79,8 +87,6 @@ Create user for git:
--home /home/git \
git
-
-
Create user for gitlab:
# ubuntu/debian
@@ -122,8 +128,7 @@ Permissions:
# if succeed you can remove it
sudo rm -rf /tmp/gitolite-admin
-** IMPORTANT! If you cant clone `gitolite-admin` repository - DONT PROCEED INSTALLATION**
-
+**IMPORTANT! If you cant clone `gitolite-admin` repository - DONT PROCEED INSTALLATION**
# 4. Install gitlab and configuration. Check status configuration.
@@ -196,8 +201,8 @@ Application can be started with next command:
./resque.sh
-** Ok - we have a working application now. **
-** But keep going - there are some thing that should be done **
+**Ok - we have a working application now. **
+**But keep going - there are some thing that should be done **
# Nginx && Unicorn