Saltar para o conteúdo principal
Conecte um projeto a um repositório do GitLab. As alterações vão nos dois sentidos, e só quando você clica em Sync: nada é sincronizado sozinho.
Um administrador precisa ativar primeiro a sincronização com GitLab.
Você faz isso uma vez.
1

Abra as configurações da conta

Clique em Account e depois em Account settings. Em Project synchronisation, encontre GitLab e clique em Link.
A seção GitLab das configurações da conta com um botão Link

GitLab nas configurações da conta

2

Autorize no GitLab

O GitLab abre. Faça login se for solicitado e depois autorize o aplicativo.
3

Verifique o vínculo

Você volta às configurações da conta. Uma mensagem verde informa que sua conta do GitLab está vinculada, e o botão agora diz Unlink.
A seção GitLab das configurações da conta com um botão Unlink

Sua conta do GitLab está vinculada

Se sua conta ainda não estiver vinculada, Import from GitLab e o cartão GitLab no editor pedem que você a vincule primeiro. Clique em Link to your GitLab account. Você também chega às configurações da conta, em uma nova aba se tiver começado no editor. Depois volte e comece de novo.
A caixa de diálogo Import from GitLab com um botão Link to your GitLab account

O aviso quando sua conta não está vinculada

Importar um repositório

Isso cria um novo projeto a partir de um repositório do GitLab, já vinculado a ele.
1

Abra a caixa de diálogo de importação

Na página de projetos, clique em New project e depois em Import from GitLab.
O menu New project com Import from GitLab

O menu New project

2

Escolha o repositório

Clique em Import to Overleaf ao lado do repositório. A lista inclui seus repositórios e os dos seus grupos.
A caixa de diálogo Import from GitLab listando quatro repositórios

Seus repositórios do GitLab

3

Verifique o projeto

O novo projeto abre com os arquivos do repositório.
O editor mostrando o projeto importado com seus arquivos e o PDF compilado

O projeto importado

Exportar um projeto para um novo repositório

Isso cria um repositório a partir de um projeto e os vincula. Um projeto só pode ser vinculado dessa forma ou por importação: não é possível vinculá-lo a um repositório que já existe.
1

Abra o GitLab no editor

Abra o projeto. Na barra à esquerda, clique em Integrations e depois em GitLab.
O painel Integrations com o cartão GitLab

O painel Integrations

2

Preencha o repositório

Escolha o Owner, que pode ser você ou um dos seus grupos. Quando você escolhe um grupo, esse campo se chama Organization. Repository Name começa com o nome do projeto. A descrição é opcional, e Private vem selecionado por padrão. Clique em Create a GitLab repository.
O formulário Export Project to GitLab preenchido

Export Project to GitLab

Se o nome já estiver em uso, a caixa de diálogo diz Please check that the repository name is valid, and that you have permission to create the repository. Altere o nome e clique no botão de novo.
3

Verifique o vínculo

A caixa de diálogo agora diz This project is linked to e nomeia o repositório.
A caixa de diálogo Sync with GitLab após a exportação

O projeto está vinculado

Sincronizar

1

Abra a caixa de diálogo de sincronização

Abra um projeto vinculado. Na barra à esquerda, clique em Integrations e depois em GitLab.Recent commits in GitLab lista o que vai entrar no projeto.
A caixa de diálogo Sync with GitLab listando um novo commit

Um novo commit esperando no GitLab

2

Descreva suas alterações

Se você alterou algo no projeto, aparece um campo para a mensagem de commit. Ele é opcional: se você deixá-lo vazio, o commit se chama Updates from Overleaf.
A caixa de diálogo Sync with GitLab com uma mensagem de commit preenchida

A mensagem de commit das suas alterações

3

Clique em Sync

Clique em Sync. Os novos commits do GitLab entram no projeto, e suas alterações vão para o branch padrão do repositório. Se os dois lados alteraram coisas diferentes, elas são mescladas para você.
4

Verifique o resultado

A caixa de diálogo mostra No new commits in GitLab since last merge. e o campo da mensagem de commit desaparece. Os arquivos no editor e os commits no GitLab estão atualizados.
A caixa de diálogo Sync with GitLab após a sincronização, sem novos commits

Tudo está sincronizado

Se as mesmas linhas mudaram dos dois lados

A caixa de diálogo informa que as alterações não puderam ser mescladas e nomeia um novo branch, overleaf-YYYY-MM-DD-HHMMSS, que contém suas alterações. O Overleaf também abre um merge request a partir desse branch no GitLab.
A caixa de diálogo Sync with GitLab com um aviso de conflito de mesclagem

Um conflito

  1. Mescle esse branch no branch padrão no GitLab ou com Git. Você pode fechar a caixa de diálogo nesse meio-tempo: ela mostra a mesma mensagem quando você a abre de novo.
  2. Clique em I have manually merged. Continue. O resultado mesclado entra no projeto. Se você clicar antes de o branch ser mesclado, a caixa de diálogo continua como está.
  3. O branch fica no GitLab, a menos que você o tenha excluído ao mesclar. Exclua-o quando não precisar mais dele.
A mesma caixa de diálogo aparece quando as regras de mesclagem do repositório retêm o merge request, por exemplo quando ele precisa de uma aprovação, mesmo que nenhuma linha esteja em conflito. Assim que a regra permitir, mescle o merge request no GitLab e clique em I have manually merged. Continue. Consulte Como a sincronização com o GitLab funciona. Faça isso quando não quiser mais que o projeto seja sincronizado.
1

Clique em Unlink

Na caixa de diálogo de sincronização, clique em Unlink.
2

Confirme

Clique em Confirm. Isso só remove o vínculo: a conexão com um repositório do qual você é dono, mencionada no aviso, é uma opção que você terá depois, não algo que acontece agora.
A caixa de diálogo Sync with GitLab pedindo para confirmar a desvinculação

Confirme a desvinculação

3

Verifique o resultado

A caixa de diálogo agora mostra Export Project to GitLab. O projeto e o repositório mantêm seu conteúdo. Para sincronizar de novo, exporte o projeto para um novo repositório ou importe o repositório para um novo projeto.
Em Account settings, em GitLab, clique em Unlink e depois em Unlink novamente na caixa de diálogo.
A caixa de diálogo Unlink GitLab Account

Desvincule sua conta

Seus projetos continuam vinculados aos repositórios. Você não pode sincronizá-los até vincular sua conta de novo.
Para saber quem pode fazer o quê em um projeto compartilhado, consulte Quem pode vincular e sincronizar.
Última modificação em 20 de novembro de 2026