> ## Documentation Index
> Fetch the complete documentation index at: https://docs.diversion.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Pause/Resume sync

> Pause and resume your background sync

Diversion's agent keeps you up to date with the latest changes in your repos by syncing them in the background. Whenever you save a change, it's automatically uploaded to your workspace and you're always backed-up.

### Auto-pause

In some error cases, such as network issues, the agent will automatically pause syncing. You can continue working normally. When committing, make sure your sync is active so you commit the most recent changes.

To resume the sync through the desktop app, turn the **Sync** toggle back on for the workspace -- on its row in the dashboard's **Local Workspaces** tab, or via the sync status pill in the repo sub-header ("Sync paused / click here to resume"). You can also run the `dv workspace resume` command in the repo's folder through the CLI.

<img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/cloned-repo-to-resume.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=264b16f0e62286701f0144cf77f3aa24" alt="Resume sync" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="1700" height="162" data-path="images/cloned-repo-to-resume.png" />

### Manual Pause/Resume

You might not want to be auto-synced, for example if you're making many small changes in a very large file, or if you're on a slow network connection.

In order to pause sync for a workspace, you first need to have it fully synced, like in the image below. Turn off the **Sync** toggle on the workspace row to pause. Resuming the sync is done in the same way mentioned above.

<img src="https://mintcdn.com/diversion-2/g_jyumy-qEjJFz_7/images/cloned-repo-to-pause.png?fit=max&auto=format&n=g_jyumy-qEjJFz_7&q=85&s=6e8f4964357072fd0c67d7383e9802ea" alt="Pause sync" style={{width: '90%', borderRadius: '1.5rem', border: '.3rem solid #555', boxShadow: '0 0 1rem #888' }} width="1700" height="162" data-path="images/cloned-repo-to-pause.png" />
