> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-pro.ayaka.space/on-premises/pt/manutencao/data-and-backups/exporting-projects.md).

# Exportar projetos

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

{% hint style="info" %}
O resultado da execução deste script é o mesmo que descarregar manualmente um ZIP de todos os projetos a partir do painel de projetos do utilizador. O script esvaziará quaisquer alterações pendentes antes de iniciar o download para garantir que a exportação contenha a versão mais recente do projeto.
{% endhint %}

### Limitações

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

* Nenhuma definição de projeto, como o nome da imagem TeX Live ou o compilador, é exportada. Estas têm de ser definidas quando o projeto é carregado para a 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 novamente partilhados. Se estiver a usar partilha por ligação, as ligações de Visualização e de Edição serão regeneradas (não serão as mesmas de antes).
* Quaisquer comentários e informações de alterações monitorizadas não serão exportados.
* O histórico de chat do projeto não será exportado.

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

### **Opções**

| Nome           | Descrição                                                                            |
| -------------- | ------------------------------------------------------------------------------------ |
| `--help`       | Mostrar ajuda                                                                        |
| `--user-id`    | O ID do utilizador (obrigatório, a menos que use `--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`  | 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á montado por bind em **/var/lib/overleaf** no seu **ficheiro docker-compose.yml** ou na `OVERLEAF_DATA_PATH` variável de ambiente no **config/overleaf.rc** ficheiro, se estiver a usar o Toolkit.

{% hint style="info" %}
O Overleaf permite atualmente nomes de projeto duplicados. Se o projeto de um utilizador contiver uma duplicação, estes projetos continuarão a ser adicionados ao ZIP de exportação do utilizador, mas, quando extraídos, apenas uma versão estará presente. No Linux, `unzip -B` irá escrever ficheiros com o mesmo nome como ficheiros de cópia de segurança em vez de os substituir.
{% 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://ayakaleaf-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.