> For the complete documentation index, see [llms.txt](https://sync.wiki.mksdtech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sync.wiki.mksdtech.com/collaboration/collaborate.md).

# Collaborate

Start or join a collaboration session on a central file.

One click puts you in the shared model with your team. **Collaborate** opens the central file: if nobody is working on it yet, you start the session, otherwise you join it. The steps are the same either way.

## Before you start

* Put the central file on a network drive or in Google Drive, OneDrive, Dropbox or Egnyte. See [Collaboration Storage](https://sync.wiki.mksdtech.com/collaboration/collaborate/collaboration-storage.md).
* Check your user name in [Settings](https://sync.wiki.mksdtech.com/reference/settings.md). You can't change it while you collaborate.
* Save your open model. Rhino Sync closes it and opens the local copy of the central file instead. If it has unsaved changes, Rhino Sync asks you to confirm first.

## Start collaborating

{% stepper %}
{% step %}

### Click Collaborate

In the **Sync** panel, click **Collaborate**. You can also run `Collaborate`.

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-3cf1d35f72ee77130b46bc9e05cdaede2e3525b9%2Fmock-toolbar-collaborate.png?alt=media" alt="The Collaborate button in the Sync panel" width="412"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose the storage

In **Open a shared model**, click a session under **RECENT** to open it again straight away, or click **Google Drive**, **OneDrive**, **Dropbox**, **Egnyte** or **Network Disk** under **OPEN FROM**. See [Collaboration Storage](https://sync.wiki.mksdtech.com/collaboration/collaborate/collaboration-storage.md).

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-615894366d0c668bc226cf22952b3af7219e8829%2Fmock-storage-picker.png?alt=media" alt="Open a shared model dialog with recent sessions and storage tiles" width="452"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Select the central file

* For **Google Drive**, **OneDrive** or **Dropbox**, sign in and pick the file in your browser. See [Google Drive](https://sync.wiki.mksdtech.com/collaboration/collaborate/collaboration-storage/google-drive.md), [OneDrive](https://sync.wiki.mksdtech.com/collaboration/collaborate/collaboration-storage/onedrive.md) or [Dropbox](https://sync.wiki.mksdtech.com/collaboration/collaborate/collaboration-storage/dropbox.md).
* For **Network Disk** under **OPEN FROM**, select the file in **Select Central File**. See [Network Drive](https://sync.wiki.mksdtech.com/collaboration/collaborate/collaboration-storage/network-drive.md).
  {% endstep %}

{% step %}

### Start or join the session

**Start Session** (or **Join Session**, when teammates are already in) shows the file, who is connected and the session's settings. **Quick changes** is ticked by default, to share edits in seconds between synchronizes. See [Quick Changes](https://sync.wiki.mksdtech.com/collaboration/quick-changes.md).

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-79c9d95ec8d758ce443c306732d86b3939f63d61%2Fmock-session-start.png?alt=media" alt="Start Session dialog" width="392"><figcaption></figcaption></figure>

When teammates are already in, the dialog reads **Join Session** and lists them with their Rhino Sync versions. You can change the session's settings before you click **Join**; the change applies to everyone.

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-51fd0fa56ae470386c23401ea493ae6ae11bd415%2Fmock-session-join.png?alt=media" alt="Join Session dialog" width="392"><figcaption></figcaption></figure>

Click **Start** or **Join**.
{% endstep %}

{% step %}

### Wait while Rhino Sync connects

Rhino Sync checks for updates, connects to the server and joins the session under your user name. It then copies the central file and opens your local copy.

<figure><img src="https://2088031227-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMFZITZJW4MHLYhDLac3k%2Fuploads%2Fgit-blob-21e6e05cf1e6854c766a6fecb3d2e92025bea47a%2Fmock-operation-connecting.png?alt=media" alt="Rhino Sync connecting progress" width="332"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Start working

The **Users** list shows you and your teammates. The status line reads `connected`.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
If a newer Rhino Sync version exists, a green notice such as `0.0.64 available` shows in **Open a shared model**. Update everyone in the team before you collaborate. See [Installation](https://sync.wiki.mksdtech.com/installation.md#updates).
{% endhint %}

## Collaborate on more than one file

Rhino Sync works on the model that is open when you click **Collaborate**. If that model is already in a session, Rhino Sync asks you to end that session first.

On Windows, opening another file ends collaboration. Rhino Sync asks you to confirm first.

## If it doesn't connect

See [Troubleshooting](https://sync.wiki.mksdtech.com/troubleshooting.md#connecting).
