2012-12-05 18:31:08 +00:00
# Hardware
2012-10-25 08:13:11 +00:00
2012-12-05 18:31:08 +00:00
We recommend you to run GitLab on a server with at least 1GB RAM.
2012-10-25 08:13:11 +00:00
2012-12-05 18:31:08 +00:00
The necessary hard disk space largely depends on the size of the repos you want
to use GitLab with. But as a *rule of thumb* you should have at least as much
free space as your all repos combined take up.
2012-10-25 08:13:11 +00:00
2012-12-05 18:31:08 +00:00
# Operating Systems
## Linux
GitLab is developed for the Linux operating system.
GitLab officially supports (recent versions of) these Linux distributions:
2012-10-25 08:13:11 +00:00
- Ubuntu Linux
- Debian/GNU Linux
2012-12-05 18:31:08 +00:00
It should also work on (though they are not officially supported):
2012-10-25 08:13:11 +00:00
2012-12-05 18:31:08 +00:00
- Arch
- CentOS
2012-10-25 08:13:11 +00:00
- Fedora
2012-12-05 18:31:08 +00:00
- Gentoo
2012-10-25 08:13:11 +00:00
- RedHat
2012-12-05 18:31:08 +00:00
## Other 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 try, please proceed with caution!**
## Windows
GitLab does **not** run on Windows and we have no plans of supporting it in the
near future.
# Rubies
2012-10-25 08:13:11 +00:00
2012-12-05 18:31:08 +00:00
GitLab requires Ruby (MRI) 1.9.3 and several Gems with native components.
While it is generally possible to use other Rubies (like
[JRuby ](http://jruby.org/ ) or [Rubinius ](http://rubini.us/ )) it might require
some work on your part.
2012-10-25 08:13:11 +00:00
2012-12-05 18:31:08 +00:00
# Installation troubles and reporting success or failure
2012-10-25 08:13:11 +00:00
2012-12-05 18:31:08 +00:00
If you have troubles installing GitLab following the official installation guide
or want to share your experience installing GitLab on a not officially supported
platform, please follow the the contribution guide (see CONTRIBUTING.md).
2013-03-23 14:56:29 +00:00
# Memory requirements
To run GitLab without any changes you need 1GB of memory. You can use it with 512MB of memory but you need to setup unicorn to use only 1 worker and you need at least 200MB of swap. On a server with 1.5GB of memory you are able to support 1000+ users.
