> For the complete documentation index, see [llms.txt](https://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://wiki.mksdtech.com/beam/installing-beam.md).

# Installation

Install BEAM on Windows or macOS

{% tabs %}
{% tab title="Windows" %}
One installer adds BEAM to Rhino 6, 7 and 8, Revit 2018 to 2027, Grasshopper and Dynamo.

1. Download the latest installer from [mksdtech.com/downloads](https://www.mksdtech.com/downloads).
2. Close every Rhino and Revit session.
3. Run `mksbeam.exe` and follow the steps. You need administrator rights.
4. Start Rhino or Revit and log in with your BEAM account. See [Licensing Scheme](/license/licencing.md).

<figure><img src="https://1008084047-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M20iL6J8Vf1nWgor7JL%2Fuploads%2Fgit-blob-392220fb291b4df53de4e8a7dad1d17d1a88858a%2Fmock-website-download.png?alt=media" alt="BEAM download page" width="640"><figcaption></figcaption></figure>

If Windows SmartScreen appears, click **More info**, then **Run anyway**.

<figure><img src="https://1008084047-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M20iL6J8Vf1nWgor7JL%2F-M5JMyrltiF57DyUiNLM%2F-M5JN9vA2XwOtTcbsXkL%2Fimage.png?alt=media&amp;token=53b61874-2c30-4b43-aeca-e171dd28adec" alt="Windows SmartScreen" width="330"><figcaption></figcaption></figure>

{% hint style="info" %}
You can also right-click the installer, choose **Properties**, tick **Unblock** and click **OK** before running it.
{% endhint %}

BEAM installs to `C:\ProgramData\Beam`. For silent installs across many machines, see [Deployment](/license/deployment.md).
{% endtab %}

{% tab title="macOS" %}
BEAM for Rhino 8 for Mac is available from the Rhino Package Manager.

1. In Rhino, run the `PackageManager` command.
2. Search for **MKSBEAM**.
3. Click **Install** and restart Rhino.
4. Log in with your BEAM account. See [Licensing Scheme](/license/licencing.md).

On macOS, BEAM includes the Rhino panel, IFC import and export, and the BEAM, BLOCS and RAY tools. Schedules, Select by Guid and Transfer are Windows only. See [Getting Started](/beam/beam-for-rhinoceros/using-rhino-beam.md#the-panel).
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Close every Rhino and Revit session before you install or update BEAM.
{% endhint %}

## RAY requirements

[RAY](/beam/beam-for-revit/ray.md) and the **RHINO** button run Rhino inside Revit, so Rhino must be installed on the same machine.

| Revit          | Rhino                                      |
| -------------- | ------------------------------------------ |
| 2019 – 2024    | Rhino 7 or 8                               |
| 2025 and later | Rhino 8, version 8.32 or later recommended |

## Updates

When a new version is available, BEAM tells you once per session and offers to open the [changelog](/changelog.md). Install the new version over the old one. There is no need to uninstall first.

## Uninstall

On Windows, uninstall **MKS BEAM** from **Settings** > **Apps**. This also removes the default [.beam directory](/beam/beam-for-rhinoceros/beam-directory.md) in `%LOCALAPPDATA%\Beam`.

On macOS, uninstall **MKSBEAM** in the Rhino Package Manager.