> ## Documentation Index > Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Gitea Synchronisation > Link your Gitea account, import or export a project, sync changes both ways and unlink. Connect a project to a Gitea repository. Changes go both ways, and only when you click **Sync**: nothing syncs on its own. > [!NOTE] > > An administrator has to turn on [Gitea Synchronisation](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md) first. ## Link your Gitea account You do this once. **1. Open your account settings** Click **Account**, then **Account settings**. Under **Project synchronisation**, find **Gitea** and click **Link**. ![The Gitea section of the account settings with a Link button](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-link.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=5514bcd66b524c3dde2376db09935feb) Gitea in the account settings **2. Authorize on Gitea** Gitea opens. Sign in if you are asked to, then authorize the application. **3. Check the link** You are back in the account settings. A green message says your Gitea account is linked, and the button now says **Unlink**. ![The Gitea section of the account settings with an Unlink button](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-linked.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b0eb94a11ff546a6770d4f5a8b5250de) Your Gitea account is linked If your account is not linked yet, **Import from Gitea** and the **Gitea** card in the editor ask you to link it first. Click **Link to your Gitea account**. You also end up in the account settings, in a new tab if you started in the editor. Then go back and start again. ![The Import from Gitea dialog with a Link to your Gitea account button](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-link-prompt.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b9f6e8fc7d3aa2d3328423f660de5a9c) The prompt when your account is not linked ## Import a repository This creates a new project from a Gitea repository, already linked to it. **1. Open the import dialog** On the projects page, click **New project**, then **Import from Gitea**. ![The New project menu with Import from Gitea](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-new-project-menu.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=de3258081da7ec5af1083ae6c127d510) The New project menu **2. Choose the repository** Click **Import to Overleaf** next to the repository. The list includes your repositories and those of your organizations. An empty repository is not listed: it needs at least one commit. ![The Import from Gitea dialog listing four repositories](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-import.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=9b8c86ed6705efddab590e0e8f62892c) Your Gitea repositories **3. Check the project** The new project opens with the files of the repository. ![The editor showing the imported project with its files and compiled PDF](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-imported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=bd72f7c7594e0f80e0966d4691598db3) The imported project ## Export a project to a new repository This creates a repository from a project and links them. A project can only be linked this way or by importing: you cannot link it to a repository that already exists. **1. Open Gitea in the editor** Open the project. In the left bar, click **Integrations**, then **Gitea**. ![The Integrations panel with the Gitea card](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-integrations.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=12710e50eecf8f3b385565c85b4a45a4) The Integrations panel **2. Fill in the repository** Choose the **Owner**, which can be you or one of your organizations. When you pick an organization, this field is called **Organization**. **Repository Name** starts as the project's name: if that name has spaces, change it, because Gitea does not accept them. The description is optional, and **Private** is selected by default. Click **Create a Gitea repository**. ![The Export Project to Gitea form filled in](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-export.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=867cf2d205d151a87dd35529b4e40d56) Export Project to Gitea If the name has spaces or is already taken, the dialog says **Please check that the repository name is valid, and that you have permission to create the repository.** Change the name and click the button again. **3. Check the link** The dialog now says **This project is linked to** and names the repository. ![The Sync with Gitea dialog after the export](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-exported.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=aa8d526d60f9733ba1885e73621ab8d6) The project is linked ## Sync **1. Open the sync dialog** Open a linked project. In the left bar, click **Integrations**, then **Gitea**. **Recent commits in Gitea** lists what will come into the project. ![The Sync with Gitea dialog listing one new commit](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-new-commits.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=0403560179cb63a6b5d3853f4590e6a5) A new commit waiting in Gitea **2. Describe your changes** If you changed something in the project, a commit message box appears. It is optional: when you leave it empty, the commit is called `Updates from Overleaf`. ![The Sync with Gitea dialog with a commit message filled in](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-commit-message.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=014cd300d4deff341310920221c63a30) The commit message for your changes **3. Click Sync** Click **Sync**. New commits from Gitea come into the project, and your changes go to the default branch of the repository. If both sides changed different things, they are merged for you through a pull request, which stays on Gitea as a record. **4. Check the result** The dialog shows **No new commits in Gitea since last merge.** and the commit message box is gone. The files in the editor and the commits on Gitea are up to date. ![The Sync with Gitea dialog after syncing, with no new commits](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-done.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=7a53483772e17e5ad75d5ceb7f44e34e) Everything is in sync ### If the same lines changed on both sides The dialog says the changes could not be merged and names a new branch, `overleaf-YYYY-MM-DD-HHMMSS`, which holds your changes. Overleaf also opens a pull request from that branch on Gitea. ![The Sync with Gitea dialog with a merge conflict warning](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-conflict.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=9acaf32d0930decd2cfce516037a37b1) A conflict 1. Merge that branch into the default branch with Git, and fix the conflict. You can close the dialog in the meantime: it shows the same message when you open it again. ```bash theme={null} git clone cd git merge origin/overleaf-YYYY-MM-DD-HHMMSS # fix the conflict in the file Git names git add git commit git push ``` 2. Click **I have manually merged. Continue**. The merged result comes into the project. If you click it before the branch is merged, the dialog stays as it is. 3. The branch stays on Gitea and its pull request stays open. Close the pull request and delete the branch when you no longer need them. The same dialog appears when a branch protection rule holds the pull request back, for example when it needs an approval, even if no lines conflict. Once the rule allows it, merge the pull request on Gitea and click **I have manually merged. Continue**. See [How syncing works with Gitea](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md#how-syncing-works-with-gitea). ## Unlink a project Do this when you no longer want the project to sync. **1. Click Unlink** In the sync dialog, click **Unlink**. **2. Confirm** Click **Confirm**. This only removes the link: the connection to a repository you own, which the warning mentions, is an option you have afterwards, not something that happens now. ![The Sync with Gitea dialog asking to confirm the unlink](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-unlink-project.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=796d5581463a481fed1772d6695430d1) Confirm the unlink **3. Check the result** The dialog now shows **Export Project to Gitea**. The project and the repository both keep their content. To sync again, export the project to a new repository, or import the repository into a new project. ## Unlink your Gitea account In **Account settings**, under **Gitea**, click **Unlink**, then **Unlink** again in the dialog. ![The Unlink Gitea Account dialog](https://mintcdn.com/ayakaleaf-pro/IsGnx0wnzqtV4hI8/images/on-premises/gitea-sync-unlink-account.png?fit=max\&auto=format\&n=IsGnx0wnzqtV4hI8\&q=85\&s=b3995614c688a587c031de666d71ce64) Unlink your account Your projects stay linked to their repositories. You cannot sync them until you link your account again. > [!NOTE] > > For who can do what in a shared project, see [Who can link and sync](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/gitea-synchronisation.md#who-can-link-and-sync). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.