diff options
| author | Achilleas Pipinellis <axilleas@axilleas.me> | 2016-05-06 09:03:58 +0000 |
|---|---|---|
| committer | Achilleas Pipinellis <axilleas@axilleas.me> | 2016-05-06 09:03:58 +0000 |
| commit | 622a33e98e68c1e08962486dd51dd912ad6c2eb7 (patch) | |
| tree | feeca5b321c194a3b8fddbecbd0b5f23e9a330d4 | |
| parent | 1070e0a84195ce1389f69c78eaf9d7539c6c6170 (diff) | |
| parent | d6f67dba0144bdae20bd86051f3eb98ce201439e (diff) | |
| download | gitlab-ce-622a33e98e68c1e08962486dd51dd912ad6c2eb7.tar.gz | |
Merge branch 'available-memory-req' into 'master'
Add note to requirements doc on swap recommendation, and ensuring enough available memory.
Called out as a result of 2GB RAM DO droplets not being enough to run backups on without adding a swap file. See: https://gitlab.com/gitlab-org/omnibus-gitlab/issues/1267
cc\ @stanhu @axil
See merge request !4060
| -rw-r--r-- | doc/install/requirements.md | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/install/requirements.md b/doc/install/requirements.md index 58f409746cd..df8e8bdc476 100644 --- a/doc/install/requirements.md +++ b/doc/install/requirements.md @@ -64,7 +64,10 @@ If you have enough RAM memory and a recent CPU the speed of GitLab is mainly lim ### Memory 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. +The operating system and any other running applications will also be using memory +so keep in mind that you need at least 2GB available before running GitLab. With +less memory GitLab will give strange errors during the reconfigure run and 500 +errors during usage. - 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. - 1GB RAM + 1GB swap supports up to 100 users but it will be very slow @@ -77,6 +80,10 @@ With less memory GitLab will give strange errors during the reconfigure run and - 128GB RAM supports up to 32,000 users - More users? Run it on [multiple application servers](https://about.gitlab.com/high-availability/) +We recommend having at least 1GB of swap on your server, even if you currently have +enough available RAM. Having swap will help reduce the chance of errors occuring +if your available memory changes. + 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. ## Gitlab Runner |