> For the complete documentation index, see [llms.txt](https://docs.coherence.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherence.io/getting-started/installation.md).

# Installation

{% hint style="info" %}
If you are looking to update, check out the [upgrade guide](/support/upgrading-unity-sdk.md) and the [release notes](/support/release-notes.md).
{% endhint %}

<details>

<summary>Supported <i class="fa-unity">:unity:</i> Unity versions</summary>

<table><thead><tr><th width="187.60546875">Unity Release Stream</th><th width="198.4921875">Unity Minimum Version</th><th>Remarks</th></tr></thead><tbody><tr><td>6.5</td><td>6000.5.0f1</td><td></td></tr><tr><td>6.4</td><td>6000.4.0f1</td><td></td></tr><tr><td>6.3 LTS</td><td>6000.3.0f1</td><td></td></tr><tr><td>6.0 LTS</td><td>6000.1.17f1</td><td></td></tr><tr><td>2022 LTS</td><td>2022.2.5f1</td><td></td></tr><tr><td>2021</td><td>2021.3.45f2</td><td>Legacy — works but not actively supported anymore.</td></tr></tbody></table>

{% hint style="info" %}
We follow Unity's release cycles closely to support `Recommeded` versions of the Unity Editor. If you experience issues working with these versions, please [reach out to us](/readme.md#join-the-community).

Additionally, we support newer versions as soon as we can. If you're on a bleeding-edge Unity version and are experiencing issues, get in touch with us.
{% endhint %}

</details>

<details>

<summary>Option 1 — Scoped Registry via Unity Editor</summary>

In your Unity project, go to **Edit** > **Project Settings**. Under [Package Manager](https://docs.unity3d.com/Manual/class-PackageManager.html), add a new Scoped Registry with the following information:

* Name: `coherence`
* URL: `https://registry.npmjs.org`
* Scope(s): `io.coherence.sdk`

<figure><img src="/files/zUyUZYcDRtyFFq5mCu1O" alt=""><figcaption></figcaption></figure>

The Scoped Registry is added. Next, let's tell Unity to install coherence from it.

Open the [Package Manager Window](https://docs.unity3d.com/Manual/upm-ui.html) via **Window** > **Package Management > Package Manager** or the icon in Unity's Main Toolbar.

<figure><img src="/files/rTs4YU0p4boGjMO57sfj" alt=""><figcaption></figcaption></figure>

coherence is available through the **My Registries** section.

<figure><img src="/files/aiiOaZ8SJc0NH8Fzhgy5" alt=""><figcaption></figcaption></figure>

Select the coherence registry in the left panel, then the coherence package in the main panel, and click **Install** in the right panel.

</details>

<details>

<summary>Option 2 — Scoped Registry via <code>manifest.json</code></summary>

{% hint style="info" %}
Refer to Unity's instructions on [adding a Scoped Registry](https://docs.unity3d.com/Manual/upm-scoped-use.html) for more in-depth documentation.
{% endhint %}

Edit `<unity-project>/Packages/manifest.json` with the additions highlighted below:

<pre class="language-json"><code class="lang-json">{
  "dependencies": {
<strong>    "io.coherence.sdk": "2.2.0",
</strong>    "com.unity.ugui": "1.0.0",
    "com.unity.modules.imgui": "1.0.0",
    /* ... */
  },
<strong>  "scopedRegistries": [
</strong><strong>    {
</strong><strong>      "name": "coherence",
</strong><strong>      "url": "https://registry.npmjs.org",
</strong><strong>      "scopes": [
</strong><strong>        "io.coherence.sdk"
</strong><strong>      ]
</strong><strong>    }
</strong><strong>  ]
</strong>}
</code></pre>

Once Unity is focused, this file is reloaded and installation begins.

</details>

<details>

<summary>Option 3 — Asset Store</summary>

[![Download on the Asset Store](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVdg1mQWQDUz5SLS0S3i2%2Fuploads%2FSN3kaiMlI76jB5QYqIs1%2Fimage.png?alt=media\&token=fd8b5088-26e6-4e88-9945-f76219ecba6b)](https://u3d.as/3q1m)

{% hint style="warning" %}
When installing through Asset Store, coherence is installed via **.unitypackage** and installs the package in `Packages/io.coherence.sdk`, becoming **embedded** (see [Unity's Documentation on Package Sources](https://docs.unity3d.com/Manual/upm-concepts.html)). This makes upgrading fragile, since files being renamed or moved will definitely break compilation and introduce unexpected issues. Refer to the [Upgrade Guide](/support/upgrading-unity-sdk.md) if you decide to use the Asset Store version.
{% endhint %}

</details>

***

{% hint style="success" %}
When you successfully install coherence, you should be welcomed with the **coherence Hub**.
{% endhint %}

<figure><img src="/files/drqQa47ZF3iASt8vDB1W" alt=""><figcaption></figcaption></figure>