> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/pt/manutencao/data-and-backups/exporting-projects.md).

# Exportar projetos

No Server Pro e Community Edition `5.4.0` incluímos um script que permite aos Administradores exportar todos os projetos do utilizador (incluindo os que ainda estão visíveis na **Eliminados** e **Lixo** pastas) para um diretório no disco.

{% hint style="info" %}
O resultado da execução deste script é o mesmo que transferir manualmente um Zip de todos os projetos a partir do painel de projetos do utilizador. O script irá esvaziar quaisquer alterações pendentes antes de iniciar a transferência, para garantir que a exportação contém a versão mais recente do projeto.
{% endhint %}

### Limitações

O script de exportação tem as seguintes limitações:

* Não são exportadas definições de projeto, como o nome da imagem do TeX Live ou o compilador. Estas têm de ser definidas quando o projeto é carregado na conta do utilizador.
* Os projetos exportados não contêm qualquer histórico de versões.
* Não é preservada qualquer informação sobre colaboradores. Os projetos terão de ser partilhados novamente. Se estiver a usar partilha por link, os links de Visualização e Edição serão regenerados (não serão iguais aos anteriores).
* Quaisquer comentários e informações de alterações rastreadas não serão exportados.
* O histórico do chat do projeto não será exportado.

{% hint style="danger" %}
Este script **não** foi concebido para substituir uma cópia de segurança completa do sistema. Para garantir que consegue recuperar a sua instância num cenário de recuperação de desastre, nós **fortemente** recomendamos fazer uma [cópia de segurança consistente](https://docs.overleaf.com/on-premises/maintenance/data-and-backups/..#performing-a-consistent-backup).
{% endhint %}

### **Opções**

| Nome           | Descrição                                                                                   |
| -------------- | ------------------------------------------------------------------------------------------- |
| `--help`       | Mostrar ajuda                                                                               |
| `--user-id`    | O ID do utilizador (obrigatório, exceto se estiver a usar `--export-all` ou `--project-id`) |
| `--project-id` | Exportar um único projeto (**não pode** ser usado com `--user-id` ou `--export-all`)        |
| `--list`       | Listar os projetos do utilizador (**não pode** ser usado com `--output`)                    |
| `--output`     | Ficheiro zip de saída (para operações de exportação única)                                  |
| `--export-all` | Exportar os projetos de todos os utilizadores (requer `--output-dir`)                       |
| `--output-dir` | Diretório para armazenar os ficheiros de exportação de todos os utilizadores                |
| `--log-level`  | Os níveis de registo suportados: `trace`\|`debug`\|`info`\|`warn`\|`error`\|`fatal`         |

### **Utilização**

Use o seguinte comando para exportar os projetos de todos os utilizadores:

{% code overflow="wrap" %}

```bash
# Utilizadores do Overleaf Toolkit
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"

# Utilizadores do docker-compose.yml legado
docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/export-user-projects.mjs --export-all --output-dir=/var/lib/overleaf/data/exports"
```

{% endcode %}

{% hint style="info" %}
Se estiver a executar Server Pro ou Community Editition <= 3.5.13, terá de atualizar o exemplo acima para usar o **`export-legacy-user-projects.js`** script.
{% endhint %}

### **Conclusão**

Assim que a exportação estiver concluída, pode aceder aos ficheiros através do diretório no host que está ligado por bind a **/var/lib/overleaf** no seu **ficheiro docker-compose.yml** ou a variável de ambiente `OVERLEAF_DATA_PATH` no **config/overleaf.rc** ficheiro, se estiver a usar o Toolkit.

{% hint style="info" %}
O Overleaf permite atualmente nomes de projetos duplicados. Se um projeto de um utilizador contiver um duplicado, esses projetos serão ainda adicionados à exportação Zip do utilizador, mas, quando extraídos, apenas uma versão estará presente. No Linux, `unzip -B` escreverá ficheiros com o mesmo nome como ficheiros de cópia de segurança, em vez de os sobrescrever.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/pt/manutencao/data-and-backups/exporting-projects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.