requirements.md 3.2 KB
Newer Older
1 2 3 4
# Operating Systems

GitLab is developed for the Linux operating system.

5
## GitLab officially supports
randx's avatar
randx committed
6 7 8 9

- Ubuntu Linux
- Debian/GNU Linux

10
## GitLab.com offers paid support for
randx's avatar
randx committed
11

12
- Red Hat Enterprise Linux (RHEL)
13
- CentOS
14 15 16 17 18
- Oracle Linux

## Not officially supported

- Arch Linux
randx's avatar
randx committed
19
- Fedora
20
- Gentoo
randx's avatar
randx committed
21

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

## Unsupported Unix Systems
25

26 27 28 29
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.
30

31
## Other operating systems such as Windows
32

33 34
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.
35 36


37
# Ruby versions
randx's avatar
randx committed
38

39 40 41 42
GitLab requires Ruby (MRI) 1.9.3 or 2.0+.
While it is generally possible to use other Rubies
(like [JRuby](http://jruby.org/) or [Rubinius](http://rubini.us/))
it might require some work since GitLab uses several Gems that have native extensions.
randx's avatar
randx committed
43 44


45
# Hardware requirements
46

47
## CPU
48

49 50 51 52
- 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
53

54
## Memory
55

56
- 512MB is too little memory, GitLab will be very slow and you will need 250MB of swap
57
- 768MB is the minimal memory size but we advise against this
58
- 1GB supports up to 100 users if you do not have individual repo's over 250MB
59 60
- **2GB** is the **recommended** memory size and supports up to 1,000 users
- 4GB supports up to 10,000 users
61 62 63 64

## Storage

The necessary hard drive space largely depends on the size of the repos you want
65
to store in GitLab. But as a *rule of thumb* you should have at least twice as much
66
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.
67

68 69 70
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.
71

72
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.
randx's avatar
randx committed
73

74
# Installation troubles and reporting success or failure
randx's avatar
randx committed
75

76
If you have troubles installing GitLab following the [official installation guide](installation.md)
77
or want to share your experience installing GitLab on a not officially supported
78
platform, please follow the the [contribution guide](/CONTRIBUTING.md).
79 80 81 82 83 84 85 86

# 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+