# Install coherence

## Install Video Tutorial

{% embed url="<https://www.youtube.com/watch?v=Rh0zeAdQ9bY&ab_channel=coherence>" %}

## Unity Package Manager

{% hint style="info" %}
**coherence** only supports **Unity** at the moment. **Unreal Engine** support is planned. For more specific details and announcements, please check the [Unreal Engine Support](https://docs.coherence.io/0.5.2/additional-information/unreal-engine-support) page. For custom engine integration,[ please contact our developer relations team](mailto:devrel@coherence.io).&#x20;
{% endhint %}

### 1. Add a scoped registry

First, open `Project Settings`.

![](https://1930722764-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MWd0ZPEK7vE9nkE0b7G%2F-MYqSIIgnCCFXlOlOVG5%2F-MYqSyLVi_zymArawu62%2Fimage.png?alt=media\&token=234f14d8-bff5-4c7d-bf2f-553c2ec3f9cb)

Under `Package Manager`, add a new Scoped Registry with the following fields:

* Name: `coherence`
* URL: `https://registry.npmjs.org`
* Scope(s): `io.coherence.sdk`
* Enable Preview Packages: `checked`
* Show Dependencies: `checked`

Click `Apply`.&#x20;

![](https://1930722764-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MWd0ZPEK7vE9nkE0b7G%2F-MYplxbk6Tbokwe53lMU%2F-MYqHGV-u9jEG_95oR5M%2Fimage.png?alt=media\&token=e85d8293-0904-400d-8407-b8322ea4220f)

### 2. Find and install the coherence package

Now open the `Package Manager`.

<div align="left"><img src="https://1930722764-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MWd0ZPEK7vE9nkE0b7G%2F-MYqSIIgnCCFXlOlOVG5%2F-MYqT7z20MbGcrJRKeKT%2Fimage.png?alt=media&#x26;token=671fdb6e-70a7-4b24-86d6-72e01a9609b6" alt=""></div>

Click `Packages` and `My Registries`.

<div align="left"><img src="https://1930722764-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MWd0ZPEK7vE9nkE0b7G%2F-MYqJ5qXOAw_haqGOxUm%2F-MYqMQ5sD5d0Frx6WEzv%2Fimage.png?alt=media&#x26;token=e2b1987f-d7e2-437c-bc74-5fdca6c562b0" alt=""></div>

Under `coherence`, click `Install`.

<div align="left"><img src="https://1930722764-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MWd0ZPEK7vE9nkE0b7G%2F-MYqJ5qXOAw_haqGOxUm%2F-MYqMWvLDDGHwS258ArC%2Fimage.png?alt=media&#x26;token=14dc65a0-ce9a-4858-b2de-750e6c6a26f8" alt=""></div>

## &#x20;Alternative Method: Edit *manifest.json* manually

If you want to install **coherence** manually, go to the folder of your project and open the file `/Packages/manifest.json`.

Copy paste the lines surrounded by comments that look like this:`/* comment */`.

```javascript
{
  "dependencies": {
    "com.unity.collab-proxy": "1.3.9",
    "com.unity.ide.rider": "2.0.7",
    "com.unity.ide.visualstudio": "2.0.7",
    "com.unity.ide.vscode": "1.2.3",
    "com.unity.test-framework": "1.1.24",
    "com.unity.textmeshpro": "3.0.1",
    "com.unity.timeline": "1.4.6",
    "com.unity.ugui": "1.0.0",

    /*** ADD THIS START ***/
    "io.coherence.sdk": "0.5.2",
    /*** ADD THIS END ***/
        
    "com.unity.modules.ai": "1.0.0",
    "com.unity.modules.androidjni": "1.0.0",
    "com.unity.modules.animation": "1.0.0",
    "com.unity.modules.assetbundle": "1.0.0",
    "com.unity.modules.audio": "1.0.0",
    "com.unity.modules.cloth": "1.0.0",
    "com.unity.modules.director": "1.0.0",
    "com.unity.modules.imageconversion": "1.0.0",
    "com.unity.modules.imgui": "1.0.0",
    "com.unity.modules.jsonserialize": "1.0.0",
    "com.unity.modules.particlesystem": "1.0.0",
    "com.unity.modules.physics": "1.0.0",
    "com.unity.modules.physics2d": "1.0.0",
    "com.unity.modules.screencapture": "1.0.0",
    "com.unity.modules.terrain": "1.0.0",
    "com.unity.modules.terrainphysics": "1.0.0",
    "com.unity.modules.tilemap": "1.0.0",
    "com.unity.modules.ui": "1.0.0",
    "com.unity.modules.uielements": "1.0.0",
    "com.unity.modules.umbra": "1.0.0",
    "com.unity.modules.unityanalytics": "1.0.0",
    "com.unity.modules.unitywebrequest": "1.0.0",
    "com.unity.modules.unitywebrequestassetbundle": "1.0.0",
    "com.unity.modules.unitywebrequestaudio": "1.0.0",
    "com.unity.modules.unitywebrequesttexture": "1.0.0",
    "com.unity.modules.unitywebrequestwww": "1.0.0",
    "com.unity.modules.vehicles": "1.0.0",
    "com.unity.modules.video": "1.0.0",
    "com.unity.modules.vr": "1.0.0",
    "com.unity.modules.wind": "1.0.0",
    "com.unity.modules.xr": "1.0.0"
  }, /* add this comma if not already present */
  
  /*** ADD THIS SECTION START ***/
  "scopedRegistries": [
    {
      "name": "coherence",
      "url": "https://registry.npmjs.org",
      "scopes": [
        "io.coherence.sdk"
      ]
    }
  ]
  /*** ADD THIS SECTION END ***/
  
}

```

{% hint style="info" %}
The Unity docs have information about [scoped package registries](https://docs.unity3d.com/Manual/upm-scoped.html).&#x20;
{% endhint %}

When you install the **coherence** Unity Package, all the services for the SDK are installed in the background as well.&#x20;

You will then see this package in the Package Manager under "My Registries".

![](https://1930722764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MWd0ZPEK7vE9nkE0b7G-1552174847%2Fuploads%2FjEKtbsd4Tt0dD8S3k0zr%2Fimage.png?alt=media\&token=51b36555-36ce-452d-9954-5b4d1385d1ee)

The **coherence** SDK has some dependencies on other Unity packages you can see in the image above. If you're already using these in your project, you might have to adjust their version number (Unity will tell you about this).

When you successfully install the coherence SDK you'll get this quickstart window pop-up and you'll be good to go.&#x20;

![](https://1930722764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MWd0ZPEK7vE9nkE0b7G-1552174847%2Fuploads%2FwUJNPli8OkSI0mFqbaq8%2Fimage.png?alt=media\&token=b56ec462-b928-4ab2-97b0-5b57edeb2964)