gitlab-org--gitlab-foss/doc/install/requirements.md

# Operating Systems

GitLab is developed for the Linux operating system.

## GitLab officially supports

- Ubuntu Linux
- Debian/GNU Linux

## GitLab.com offers paid support for

- Red Hat Enterprise Linux (RHEL)
- CentOS
- Oracle Linux

## Not officially supported

- Arch Linux
- Fedora
- Gentoo

On the above distributions it is pretty easy to install GitLab yourself.

## Unsupported Unix Systems

There is nothing that prevents GitLab from running on other Unix operating systems.
This means you may get it to work on systems running FreeBSD or OS X.
If you want to do this, please be aware it could be a lot of work.
Please consider using a virtual machine to run GitLab.

## Other operating systems such as Windows

GitLab does **not** run on Windows and we have no plans of supporting it in the near future.
Please consider using a virtual machine to run GitLab.


# Ruby versions

GitLab requires Ruby (MRI) 1.9.3 or 2.0+.
You will have to use the standard MRI implementation of Ruby.
We love [JRuby](http://jruby.org/) and [Rubinius](http://rubini.us/)) but GitLab needs several Gems that have native extensions.


# Hardware requirements

## CPU

- 1 core works for under 100 users but the responsiveness might suffer
- **2 cores** is the **recommended** number of cores and supports up to 100 users
- 4 cores supports about 1,000 users
- 8 cores supports up to 10,000 users

## Memory

- 512MB is too little memory, GitLab will be very slow and you will need 250MB of swap
- 768MB is the minimal memory size but we advise against this
- 1GB supports up to 100 users (with individual repositories under 250MB, otherwise git memory usage necessitates using swap space)
- **2GB** is the **recommended** memory size and supports up to 1,000 users
- 4GB supports up to 10,000 users

## Storage

The necessary hard drive space largely depends on the size of the repos you want
to store in GitLab. But as a *rule of thumb* you should have at least twice as much
free space as your all repos combined take up. You need twice the storage because [GitLab satellites](structure.md) contain an extra copy of each repo.

If you want to be flexible about growing your hard drive space in the future consider mounting it using LVM so you can add more hard drives when you need them.

Apart from a local hard drive you can also mount a volume that supports the network file system (NFS) protocol. This volume might be located on a file server, a network attached storage (NAS) device, a storage area network (SAN) or on an Amazon Web Services (AWS) Elastic Block Store (EBS) volume.

If you have enough RAM memory and a recent CPU the speed of GitLab is mainly limited by hard drive seek times. Having a fast drive (7200 RPM and up) or a solid state drive (SSD) will improve the responsiveness of GitLab.

# Installation troubles and reporting success or failure

If you have troubles installing GitLab following the [official installation guide](installation.md)
or want to share your experience installing GitLab on a not officially supported
platform, please follow the the [contribution guide](/CONTRIBUTING.md).

# Supported webbrowsers

- Chrome (Latest stable version)
- Firefox (Latest released version) 
- Safari 7+ (Know problem: required fields in html5 do not work)
- Opera (Latest released version)
- IE 10+
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00			`# Operating Systems`

			`GitLab is developed for the Linux operating system.`

Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`## GitLab officially supports`
Decouple requirements and install 2012-10-25 04:13:11 -04:00
			`- Ubuntu Linux`
			`- Debian/GNU Linux`

Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`## GitLab.com offers paid support for`
Decouple requirements and install 2012-10-25 04:13:11 -04:00
Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`- Red Hat Enterprise Linux (RHEL)`
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00			`- CentOS`
Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`- Oracle Linux`

			`## Not officially supported`

			`- Arch Linux`
Decouple requirements and install 2012-10-25 04:13:11 -04:00			`- Fedora`
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00			`- Gentoo`
Decouple requirements and install 2012-10-25 04:13:11 -04:00
Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`On the above distributions it is pretty easy to install GitLab yourself.`

			`## Unsupported Unix Systems`
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00
Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`There is nothing that prevents GitLab from running on other Unix operating systems.`
			`This means you may get it to work on systems running FreeBSD or OS X.`
			`If you want to do this, please be aware it could be a lot of work.`
			`Please consider using a virtual machine to run GitLab.`
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00
Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`## Other operating systems such as Windows`
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00
Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`GitLab does not run on Windows and we have no plans of supporting it in the near future.`
			`Please consider using a virtual machine to run GitLab.`
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00

Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`# Ruby versions`
Decouple requirements and install 2012-10-25 04:13:11 -04:00
Ensure customers know that GitLab.com supports RHEL. 2013-11-21 13:38:05 -05:00			`GitLab requires Ruby (MRI) 1.9.3 or 2.0+.`
Nobody uses GitLab with Jruby. 2014-01-25 11:57:18 -05:00			`You will have to use the standard MRI implementation of Ruby.`
			`We love [JRuby](http://jruby.org/) and [Rubinius](http://rubini.us/)) but GitLab needs several Gems that have native extensions.`
Decouple requirements and install 2012-10-25 04:13:11 -04:00

Updating based on Dmitriy his comments. 2013-03-24 17:23:28 -04:00			`# Hardware requirements`
Better header and detail why you need two times the storage. Also moving memory and storage to the bottom, OS is more important. 2013-03-24 06:02:39 -04:00
Updating based on Dmitriy his comments. 2013-03-24 17:23:28 -04:00			`## CPU`
Better header and detail why you need two times the storage. Also moving memory and storage to the bottom, OS is more important. 2013-03-24 06:02:39 -04:00
Better requirements based on the experience of GitLab Cloud. 2013-10-04 06:20:40 -04:00			`- 1 core works for under 100 users but the responsiveness might suffer`
			`- 2 cores is the recommended number of cores and supports up to 100 users`
			`- 4 cores supports about 1,000 users`
			`- 8 cores supports up to 10,000 users`
Better header and detail why you need two times the storage. Also moving memory and storage to the bottom, OS is more important. 2013-03-24 06:02:39 -04:00
Updating based on Dmitriy his comments. 2013-03-24 17:23:28 -04:00			`## Memory`
Better header and detail why you need two times the storage. Also moving memory and storage to the bottom, OS is more important. 2013-03-24 06:02:39 -04:00
fixed fact about memory usage 2013-05-13 03:34:46 -04:00			`- 512MB is too little memory, GitLab will be very slow and you will need 250MB of swap`
Better requirements based on the experience of GitLab Cloud. 2013-10-04 06:20:40 -04:00			`- 768MB is the minimal memory size but we advise against this`
Explain the culprit and consequences of the 1GB memory recommendation. 2014-01-20 07:24:19 -05:00			`- 1GB supports up to 100 users (with individual repositories under 250MB, otherwise git memory usage necessitates using swap space)`
Better requirements based on the experience of GitLab Cloud. 2013-10-04 06:20:40 -04:00			`- 2GB is the recommended memory size and supports up to 1,000 users`
			`- 4GB supports up to 10,000 users`
Updating based on Dmitriy his comments. 2013-03-24 17:23:28 -04:00
			`## Storage`

			`The necessary hard drive space largely depends on the size of the repos you want`
Better header and detail why you need two times the storage. Also moving memory and storage to the bottom, OS is more important. 2013-03-24 06:02:39 -04:00			`to store in GitLab. But as a rule of thumb you should have at least twice as much`
Better requirements based on the experience of GitLab Cloud. 2013-10-04 06:20:40 -04:00			`free space as your all repos combined take up. You need twice the storage because [GitLab satellites](structure.md) contain an extra copy of each repo.`
Better header and detail why you need two times the storage. Also moving memory and storage to the bottom, OS is more important. 2013-03-24 06:02:39 -04:00
Better requirements based on the experience of GitLab Cloud. 2013-10-04 06:20:40 -04:00			`If you want to be flexible about growing your hard drive space in the future consider mounting it using LVM so you can add more hard drives when you need them.`

			`Apart from a local hard drive you can also mount a volume that supports the network file system (NFS) protocol. This volume might be located on a file server, a network attached storage (NAS) device, a storage area network (SAN) or on an Amazon Web Services (AWS) Elastic Block Store (EBS) volume.`
Updating based on Dmitriy his comments. 2013-03-24 17:23:28 -04:00
Better requirements based on the experience of GitLab Cloud. 2013-10-04 06:20:40 -04:00			`If you have enough RAM memory and a recent CPU the speed of GitLab is mainly limited by hard drive seek times. Having a fast drive (7200 RPM and up) or a solid state drive (SSD) will improve the responsiveness of GitLab.`
Decouple requirements and install 2012-10-25 04:13:11 -04:00
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00			`# Installation troubles and reporting success or failure`
Decouple requirements and install 2012-10-25 04:13:11 -04:00
update links to be relative paths and add CONTRIBUTING.md link 2013-05-13 03:48:08 -04:00			`If you have troubles installing GitLab following the [official installation guide](installation.md)`
Update hardware and platform requirements guide 2012-12-05 13:31:08 -05:00			`or want to share your experience installing GitLab on a not officially supported`
update links to be relative paths and add CONTRIBUTING.md link 2013-05-13 03:48:08 -04:00			`platform, please follow the the [contribution guide](/CONTRIBUTING.md).`
Added webbrowser requirements Fixes https://github.com/gitlabhq/gitlabhq/issues/4319 2014-01-14 11:47:12 -05:00
			`# Supported webbrowsers`

			`- Chrome (Latest stable version)`
			`- Firefox (Latest released version)`
			`- Safari 7+ (Know problem: required fields in html5 do not work)`
			`- Opera (Latest released version)`
			`- IE 10+`