diff --git a/doc/install/installation.md b/doc/install/installation.md index 3af3d2bfe7a7f0a875499f717e84ac11222b6953..b9bde01c2fac6d3f256749f0fe49f7c4ddbb4abe 100644 --- a/doc/install/installation.md +++ b/doc/install/installation.md @@ -45,6 +45,15 @@ You can select the branch in the version dropdown in the top left corner of GitL If the highest number stable branch is unclear, check the [GitLab blog](https://about.gitlab.com/blog/) for installation guide links by version. +## Software requirements + +| Software | Minimum version | Notes | +| -------- | --------------- | ----- | +| [Ruby](#2-ruby) | `2.7` | From GitLab 13.6, Ruby 2.7 is required. Ruby 3.0 is not supported yet (see [the relevant epic](https://gitlab.com/groups/gitlab-org/-/epics/5149) for the current status). You must use the standard MRI implementation of Ruby. We love [JRuby](https://www.jruby.org/) and [Rubinius](https://github.com/rubinius/rubinius#the-rubinius-language-platform), but GitLab needs several Gems that have native extensions. | +| [Go](#3-go) | `1.15` | | +| [Git](#git) | `2.31.x` | From GitLab 13.11, Git 2.31.x and later is required. It's highly recommended that you use the [Git version provided by Gitaly](#git). | +| [Node.js](#4-node) | `12.22.1` | GitLab uses [webpack](https://webpack.js.org/) to compile frontend assets. Node.js 14.x is recommended, as it's faster. You can check which version you're running with `node -v`. You need to update it to a newer version if needed. | + ## GitLab directory structure This is the main directory structure you end up with following the instructions @@ -207,7 +216,7 @@ sudo apt-get install -y libimage-exiftool-perl ## 2. Ruby The Ruby interpreter is required to run GitLab. -See the [requirements page](requirements.md#ruby-versions) for the minimum +See the [requirements section of this page](#software-requirements) for the minimum Ruby requirements. The use of Ruby version managers such as [`RVM`](https://rvm.io/), [`rbenv`](https://github.com/rbenv/rbenv) or [`chruby`](https://github.com/postmodern/chruby) with GitLab diff --git a/doc/install/requirements.md b/doc/install/requirements.md index 9aa06030c24c4c16f8500b969aa14d40f83fa3fb..5c723ee06cdde0384ca9d470b209ce399ac39fe5 100644 --- a/doc/install/requirements.md +++ b/doc/install/requirements.md @@ -47,55 +47,6 @@ Please consider using a virtual machine to run GitLab. ## Software requirements -### Ruby versions - -From GitLab 13.6: - -- Ruby 2.7 and later is required. - -From GitLab 12.2: - -- Ruby 2.6 and later is required. - -You must use the standard MRI implementation of Ruby. -We love [JRuby](https://www.jruby.org/) and [Rubinius](https://github.com/rubinius/rubinius#the-rubinius-language-platform), but GitLab -needs several Gems that have native extensions. - -### Go versions - -The minimum required Go version is 1.13. - -### Git versions - -From GitLab 13.11: - -- Git 2.31.x and later is required. We recommend you use the - [Git version provided by Gitaly](installation.md#git). - -From GitLab 13.6: - -- Git 2.29.x and later is required. - -From GitLab 13.1: - -- Git 2.24.x and later is required. -- Git 2.28.x and later [is recommended](https://gitlab.com/gitlab-org/gitaly/-/issues/2959). - -### Node.js versions - -Beginning in GitLab 12.9, we only support Node.js 10.13.0 or higher, and we have dropped -support for Node.js 8. (Node.js 6 support was dropped in GitLab 11.8) - -We recommend Node 14.x, as it's faster. - -GitLab uses [webpack](https://webpack.js.org/) to compile frontend assets, which requires a minimum -version of Node.js 10.13.0. - -You can check which version you're running with `node -v`. If you're running -a version older than `v10.13.0`, you need to update it to a newer version. You -can find instructions to install from community maintained packages or compile -from source at the [Node.js website](https://nodejs.org/en/download/). - ### Redis versions GitLab 13.0 and later requires Redis version 4.0 or higher. diff --git a/doc/update/upgrading_from_source.md b/doc/update/upgrading_from_source.md index 93d2c2cb2881d6b528f50d5914747f7eb753759d..78eb6fab10bcfbe7bf372ceca5590dfcba13c2d5 100644 --- a/doc/update/upgrading_from_source.md +++ b/doc/update/upgrading_from_source.md @@ -82,7 +82,7 @@ sudo make install ### 4. Update Node.js -To check the minimum required Node.js version, see [Node.js versions](../install/requirements.md#nodejs-versions). +To check the minimum required Node.js version, see [Node.js versions](../install/installation.md#software-requirements). GitLab also requires the use of Yarn `>= v1.10.0` to manage JavaScript dependencies. @@ -99,7 +99,7 @@ More information can be found on the [Yarn website](https://classic.yarnpkg.com/ ### 5. Update Go -To check the minimum required Go version, see [Go versions](../install/requirements.md#go-versions). +To check the minimum required Go version, see [Go versions](../install/installation.md#software-requirements). You can check which version you are running with `go version`. @@ -119,12 +119,8 @@ rm go1.13.5.linux-amd64.tar.gz ### 6. Update Git -WARNING: -From GitLab 13.1, you must use at least Git v2.24 (previous minimum version was v2.22). -Git v2.28 is recommended. - To check you are running the minimum required Git version, see -[Git versions](../install/requirements.md#git-versions). +[Git versions](../install/installation.md#software-requirements). From GitLab 13.6, we recommend you use the [Git version provided by Gitaly](https://gitlab.com/gitlab-org/gitaly/-/issues/2729)