# Instalar o GitLab em uma URL relativa Embora recomendemos instalar o GitLab em seu próprio (sub)domínio, às vezes isso não é possível devido a vários motivos. Nesse caso, o GitLab também pode ser instalado em uma URL relativa, por exemplo . Este documento descreve como executar o GitLab em um URL relativo para instalações a partir do código-fonte. Se você estiver usando um pacote Omnibus, [the steps are different](https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-a-relative-url-for-gitlab). Use este guia junto com o [installation guide](https://docs.gitlab.com/ee/install/installation.html) se você estiver instalando o GitLab pela primeira vez. Não há limite para a profundidade de aninhamento da URL relativa. Por exemplo, você pode servir o GitLab em /foo/bar/gitlab/git sem problemas. Alterar a URL em uma instalação existente do GitLab altera todas as URLs remotas, então você precisa editá-las manualmente em qualquer repositório local que aponte para sua instância do GitLab. A lista de arquivos de configuração que você deve alterar para servir o GitLab a partir de uma URL relativa é: * `/home/git/gitlab/config/initializers/relative_url.rb` * `/home/git/gitlab/config/gitlab.yml` * `/home/git/gitlab/config/puma.rb` * `/home/git/gitlab-shell/config.yml` * `/etc/default/gitlab` Depois de todas as mudanças, você deve recompilar os ativos e [restart GitLab](https://docs.gitlab.com/ee/administration/restart_gitlab.html#installations-from-source). ### Requisitos relativos de URL Se você configurar o GitLab com uma URL relativa, os recursos (incluindo JavaScript, CSS, fontes e imagens) deverão ser recompilados, o que pode consumir muitos recursos de CPU e memória. Para evitar erros de falta de memória, você deve ter pelo menos 2 GB de RAM disponível em seu computador e recomendamos 4 GB de RAM e quatro ou oito núcleos de CPU. Veja o [requirements](https://docs.gitlab.com/ee/install/requirements.html) para mais informações. ### Ativar URL relativo no GitLab Não faça alterações no arquivo de configuração do servidor da Web em relação à URL relativa. O suporte de URL relativo é implementado pelo GitLab Workhorse. Antes de seguir as etapas abaixo para ativar a URL relativa no GitLab, algumas suposições são feitas:Before following the steps below to enable relative URL in GitLab, some assumptions are made: * GitLab é o servidor sob `/gitlab` * O diretório no qual o GitLab está instalado é `/home/git/` Certifique-se de seguir todas as etapas abaixo: 1. Opcional. Se você ficar sem recursos, poderá liberar temporariamente um pouco de memória desligando o serviço GitLab com o seguinte comando: ``` sudo service gitlab stop ``` crie`/home/git/gitlab/config/initializers/relative_url.rb` ``` cp /home/git/gitlab/config/initializers/relative_url.rb.sample \ /home/git/gitlab/config/initializers/relative_url.rb ``` e altere a seguinte linha: ``` config.relative_url_root = "/gitlab" ``` edite`/home/git/gitlab/config/gitlab.yml` and uncomment/change a seguinte linha: ``` relative_url_root: /gitlab ``` Edite `/home/git/gitlab/config/puma.rb` e descomente/altere a seguinte linha: ``` ENV['RAILS_RELATIVE_URL_ROOT'] = "/gitlab" ``` Edite`/home/git/gitlab-shell/config.yml` e acrescente o caminho relativo à seguinte linha: ``` gitlab_url: http://127.0.0.1/gitlab ``` Certifique-se de ter copiado os serviços systemd fornecidos ou o script de inicialização e o arquivo padrão, conforme indicado no [installation guide](https://docs.gitlab.com/ee/install/installation.html#install-the-service). Em seguida, edite `/etc/default/gitlab` e defina`gitlab_workhorse_options` o `-authBackend` configuração para ler como: ``` -authBackend http://127.0.0.1:8080/gitlab ``` 1. Se você estiver usando um script de inicialização personalizado, certifique-se de editar a configuração do GitLab Workhorse acima conforme necessário. 2. [Restart GitLab](https://docs.gitlab.com/ee/administration/restart_gitlab.html#installations-from-source) para que as alterações entrem em vigor. ### Desativar URL relativo no GitLab Para desabilitar a URL relativa: 1. Remove `/home/git/gitlab/config/initializers/relative_url.rb` 2. Siga o mesmo procedimento acima a partir de 2. e configure a URL do GitLab para uma que não contenha um caminho relativo. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://liedsons-organization.gitbook.io/gitlab-no-ubuntu/~/changes/v2SMoF2OR3hlOcgvW1pm/instalacao-e-configuracao-source/instalar-o-gitlab-em-uma-url-relativa.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.