# Advanced setup for GitLab Docs

Instead of relying on `make setup` in the [basic setup instructions](setup.md), you can install GitLab Docs
dependencies yourself. The dependencies are:

- System dependencies. The list of required software is in [Brewfile](/Brewfile). On Linux, install these packages manually.
- Ruby.
- Node.js and Yarn.

## Install Ruby

To install Ruby using [`rbenv`](https://github.com/rbenv/rbenv):

1. [Install `rbenv`](https://github.com/rbenv/rbenv#installation).
1. Install the [supported version of Ruby](https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/.ruby-version):

   ```shell
   rbenv install <supported-version>
   ```

1. Use the newly-installed Ruby:

   ```shell
   rbenv global <supported-version>
   ```

Check your:

- Ruby version with `ruby --version`.
- Bundler version with `bundle --version`.

## Install Node.js

To install Node.js using [`nvm`](https://github.com/nvm-sh/nvm):

1. [Install `nvm`](https://github.com/nvm-sh/nvm#installation-and-update).
1. Install the [supported version of Node.js](https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/.nvmrc):

   ```shell
   nvm install <supported-version>
   ```

1. Use the newly-installed Node.js:

   ```shell
   nvm use <supported-version> --default
   ```

Check your Node.js version with `node -v`.

### Install Yarn

Install [yarn](https://yarnpkg.com/en/docs/install), a package manager for the Node.js ecosystem.