> 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/installation/it-deployment.md).

# Deployment for IT teams

Deploy Rhino Sync to many computers, open the firewall and pre-configure user settings.

This page is for administrators who install Rhino Sync for a team.

## Checklist

* Every computer runs Rhino 8.21 or later on .NET Core, or Rhino 9.
* Every computer runs the same Rhino Sync version.
* Every user has a unique Rhino Sync user name.
* The firewall allows the hosts below.
* Every user can read and write the folder that holds the central file.

## Install silently on Windows

The installer is an Inno Setup package. It installs for all users and needs administrator rights.

```
Rhino.Sync.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /LOG="C:\Temp\RhinoSync-install.log"
```

Close Rhino on the target computer first. The installer replaces the files of any previous version.

| Item           | Value                                                                                                             |
| -------------- | ----------------------------------------------------------------------------------------------------------------- |
| Install folder | `C:\ProgramData\Rhino.Sync\App\8\` for Rhino 8 and `App\9\` for Rhino 9                                           |
| Plug-in file   | `Rhino.Sync.rhp` in each install folder                                                                           |
| Registration   | Plug-in keys under `HKEY_LOCAL_MACHINE\SOFTWARE\McNeel\Rhinoceros\8.0\Plug-ins` and `...\Rhinoceros\9.0\Plug-ins` |
| Uninstaller    | `C:\ProgramData\Rhino.Sync\Uninstall\unins000.exe`                                                                |

To detect the installation, check that `Rhino.Sync.rhp` exists in either install folder.

To remove Rhino Sync silently, run:

```
"C:\ProgramData\Rhino.Sync\Uninstall\unins000.exe" /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
```

## Install with the Package Manager

On macOS, and on Windows if you prefer packages, install **RhinoSync** from the Rhino Package Manager. The Package Manager installs per user. See [Rhino Package Manager for Windows and macOS](/installation/package-manager.md).

Don't combine the installer and the package on the same computer.

## Network access

Allow outbound HTTPS on port 443, including WebSocket upgrades, to these hosts:

| Host                                                                                                                                              | Used for                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `sync.mksdtech.com`                                                                                                                               | Collaboration server. Required.                      |
| `api.github.com`                                                                                                                                  | Update check when a user clicks **Collaborate**.     |
| `accounts.google.com`, `apis.google.com`, `www.googleapis.com`                                                                                    | Google Drive sign-in, file picker and file transfer. |
| `login.microsoftonline.com`, `graph.microsoft.com`, `onedrive.live.com`, `api.onedrive.com`, `*.microsoftpersonalcontent.com`, `*.sharepoint.com` | OneDrive sign-in, file picker and file transfer.     |
| `www.dropbox.com`, `api.dropboxapi.com`, `content.dropboxapi.com`                                                                                 | Dropbox sign-in, file picker and file transfer.      |
| `storage.googleapis.com`                                                                                                                          | Large live previews.                                 |

To test access, open `https://sync.mksdtech.com/collaborationHub` in a browser on the user's computer. The page shows `Connection ID required`.

For a network drive, users also need SMB access to the share.

## Storage

For a network drive:

* Give every user read, write and create permission on the folder that holds the central file. Rhino Sync creates a `_collab` folder next to it.
* Users can map the share to different drive letters.
* Measure speed in **Settings** while collaborating. See [Settings](/reference/settings.md).

For cloud storage, each user needs an account with edit access to the central file:

* **Google Drive**: a Google account.
* **OneDrive**: a personal Microsoft account, or a work or school account. Rhino Sync asks for access to the user's files and to files shared with them (`Files.ReadWrite.All`). If your tenant requires admin consent for apps, approve Rhino Sync in Microsoft Entra before users collaborate.
* **Dropbox**: a Dropbox account. The user must be signed in to the same Dropbox account in their browser when they pick the file.

## Pre-configure user settings

Rhino Sync keeps per-user settings in `settings.json`. You can place this file before a user first starts Rhino.

{% tabs %}
{% tab title="Windows" %}
`%AppData%\Rhino.Sync\settings.json`
{% endtab %}

{% tab title="macOS" %}
`~/Library/Application Support/Rhino.Sync/settings.json`
{% endtab %}
{% endtabs %}

```json
{
  "UserName": "Hana",
  "UserColor": "#3AD23F",
  "Theme": "Auto",
  "EnableDebugMessages": false,
  "BroadcastDeltas": false,
  "ReceiveDeltas": true
}
```

| Key                   | Values                                                   | Default                             |
| --------------------- | -------------------------------------------------------- | ----------------------------------- |
| `UserName`            | Letters, numbers and spaces. Must be unique in the team. | The Windows or macOS account name   |
| `UserColor`           | Hex colour such as `#3AD23F`                             | A colour derived from the user name |
| `Theme`               | `Auto`, `Light` or `Dark` (Windows only)                 | `Auto`                              |
| `EnableDebugMessages` | `true` or `false`                                        | `false`                             |
| `BroadcastDeltas`     | `true` or `false`. Sends live previews.                  | `false`                             |
| `ReceiveDeltas`       | `true` or `false`. Shows teammates' live previews.       | `true`                              |

{% hint style="warning" %}
Set `UserName` explicitly if account names contain dots or other symbols. Two people with the same user name can't collaborate at the same time.
{% endhint %}

See [Files and locations](/reference/files-and-locations.md) for every folder Rhino Sync uses.