BigW Consortium Gitlab

requirements.md 6.24 KB
Newer Older
1 2 3
# Requirements

## Operating Systems
4

5
### Supported Unix distributions
6

7 8
- Ubuntu
- Debian
9
- CentOS
10
- Red Hat Enterprise Linux (please use the CentOS packages and instructions)
11 12
- Scientific Linux (please use the CentOS packages and instructions)
- Oracle Linux (please use the CentOS packages and instructions)
13

14 15
For the installations options please see [the installation page on the GitLab website](https://about.gitlab.com/installation/).

16
### Unsupported Unix distributions
17

18
- OS X
19
- Arch Linux
20
- Fedora
21
- Gentoo
22
- FreeBSD
23

24
On the above unsupported distributions is still possible to install GitLab yourself.
25
Please see the [installation from source guide](installation.md) and the [installation guides](https://about.gitlab.com/installation/) for more information.
26

27
### Non-Unix operating systems such as Windows
28

29
GitLab is developed for Unix operating systems.
30
GitLab does **not** run on Windows and we have no plans of supporting it in the near future.
31
Please consider using a virtual machine to run GitLab.
32

33
## Ruby versions
34

James Lopez committed
35
GitLab requires Ruby (MRI) 2.1.x and currently does not work with versions 2.2 or 2.3.
36

dosire committed
37
You will have to use the standard MRI implementation of Ruby.
38 39
We love [JRuby](http://jruby.org/) and [Rubinius](http://rubini.us/) but GitLab
needs several Gems that have native extensions.
40

41
## Hardware requirements
42

43 44
### Storage

45
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 as much free space as all your repos combined take up.
46 47 48 49 50 51 52

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.

53
### CPU
54

Sytse Sijbrandij committed
55
- 1 core works supports up to 100 users but the application can be a bit slower due to having all workers and background jobs running on the same core
dosire committed
56 57 58
- **2 cores** is the **recommended** number of cores and supports up to 500 users
- 4 cores supports up to 2,000 users
- 8 cores supports up to 5,000 users
59 60 61
- 16 cores supports up to 10,000 users
- 32 cores supports up to 20,000 users
- 64 cores supports up to 40,000 users
62
- More users? Run it on [multiple application servers](https://about.gitlab.com/high-availability/)
63

64
### Memory
65

66 67 68
You need at least 2GB of addressable memory (RAM + swap) to install and use GitLab!
With less memory GitLab will give strange errors during the reconfigure run and 500 errors during usage.

69
- 512MB RAM + 1.5GB of swap is the absolute minimum but we strongly **advise against** this amount of memory. See the unicorn worker section below for more advice.
70 71
- 1GB RAM + 1GB swap supports up to 100 users but it will be very slow
- **2GB RAM** is the **recommended** memory size for all installations and supports up to 100 users
72 73 74 75 76 77
- 4GB RAM supports up to 1,000 users
- 8GB RAM supports up to 2,000 users
- 16GB RAM supports up to 4,000 users
- 32GB RAM supports up to 8,000 users
- 64GB RAM supports up to 16,000 users
- 128GB RAM supports up to 32,000 users
78
- More users? Run it on [multiple application servers](https://about.gitlab.com/high-availability/)
79

80
Notice: The 25 workers of Sidekiq will show up as separate processes in your process overview (such as top or htop) but they share the same RAM allocation since Sidekiq is a multithreaded application. Please see the section below about Unicorn workers for information about many you need of those.
81

82
## Unicorn Workers
83

Phil Hughes committed
84
It's possible to increase the amount of unicorn workers and this will usually help for to reduce the response time of the applications and increase the ability to handle parallel requests.
85

86 87
For most instances we recommend using: CPU cores + 1 = unicorn workers.
So for a machine with 2 cores, 3 unicorn workers is ideal.
88

89
For all machines that have 1GB and up we recommend a minimum of three unicorn workers.
90 91 92
If you have a 512MB machine with a magnetic (non-SSD) swap drive we recommend to configure only one Unicorn worker to prevent excessive swapping.
With one Unicorn worker only git over ssh access will work because the git over HTTP access requires two running workers (one worker to receive the user request and one worker for the authorization check).
If you have a 512MB machine with a SSD drive you can use two Unicorn workers, this will allow HTTP access although it will be slow due to swapping.
93

94 95
To change the Unicorn workers when you have the Omnibus package please see [the Unicorn settings in the Omnibus GitLab documentation](https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/doc/settings/unicorn.md#unicorn-settings).

96 97
## Database

98
If you want to run the database separately expect a size of about 1 MB per user.
99

100 101 102 103 104 105 106 107 108 109 110
### PostgreSQL Requirements

Users using PostgreSQL must ensure the `pg_trgm` extension is loaded into every
GitLab database. This extension can be enabled (using a PostgreSQL super user)
by running the following query for every database:

    CREATE EXTENSION pg_trgm;

On some systems you may need to install an additional package (e.g.
`postgresql-contrib`) for this extension to become available.

111 112 113
## Redis and Sidekiq

Redis stores all user sessions and the background task queue.
Sytse Sijbrandij committed
114
The storage requirements for Redis are minimal, about 25kB per user.
115 116
Sidekiq processes the background jobs with a multithreaded process.
This process starts with the entire Rails stack (200MB+) but it can grow over time due to memory leaks.
Ben Bodenmiller committed
117
On a very active server (10,000 active users) the Sidekiq process can use 1GB+ of memory.
118

119
## Supported web browsers
120 121

- Chrome (Latest stable version)
122
- Firefox (Latest released version and [latest ESR version](https://www.mozilla.org/en-US/firefox/organizations/))
Pascal Herbert committed
123
- Safari 7+ (known problem: required fields in html5 do not work)
124
- Opera (Latest released version)
125
- Internet Explorer (IE) 10+ but please make sure that you have the `Compatibility View` mode disabled.