> 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/troubleshooting.md).

# Troubleshooting

Common messages and how to fix them

Find the message you see, then follow the fix. If the problem stays, email <info@mksdtech.com> with the message, your BEAM version and your Rhino or Revit version.

## Licensing

<details>

<summary>Please register and login to use BEAM.</summary>

You are not logged in. Open the license dialog and log in with your BEAM account. See [Licensing Scheme](/license/licencing.md).

</details>

<details>

<summary>Check your internet connection or if your firewall is blocking api.mksdtech.com</summary>

BEAM needs to reach `api.mksdtech.com` over HTTPS to check your licence. Check your connection. On a company network, ask IT to allow `api.mksdtech.com`. See [Deployment](/license/deployment.md#network).

</details>

<details>

<summary>All BEAM PRO licenses are in use.</summary>

Every device slot of your team's licences is taken for today. Slots are released at the end of the day. Ask your account owner for more licences at [mksdtech.com](https://www.mksdtech.com/). See [Licensing Scheme](/license/licencing.md#beam-pro-standard).

</details>

<details>

<summary>You have exceeded the BEAM LITE limits.</summary>

You are using BEAM LITE, which limits the size of each import and export. Get a BEAM PRO licence for unlimited use, or ask your team owner to invite you. See [Licensing Scheme](/license/licencing.md).

</details>

## Files

<details>

<summary>Cannot read this BEAM file. It was created with an older version of BEAM that is no longer compatible.</summary>

Export the *.beam* again from Rhino with the same BEAM version you use in Revit. Keep Rhino and Revit on the same BEAM version.

</details>

<details>

<summary>Revit Family Templates not found.</summary>

The family templates are missing from `C:\ProgramData\Beam\Templates`. Run the BEAM installer again.

</details>

<details>

<summary>Document units not supported</summary>

IFC export needs metres, centimetres, millimetres, feet or inches. Change the units in Rhino's **Document Properties** > **Units**.

</details>

<details>

<summary>Some objects were not exported or imported</summary>

BEAM lists the failed objects with the reason. Click **Copy To Clipboard**, then use [Select by Guid](/beam/beam-for-rhinoceros/beam.md#select-by-guid) in Rhino to find them. Common causes:

* Invalid or non-manifold geometry. Run Rhino's `Check` command.
* Names with invalid characters: ``\ : { } [ ] | ; < > ? ` ~ " /``.
* Scaled or skewed blocks. See [BLOCS](/beam/beam-for-rhinoceros/blocs.md).

</details>

<details>

<summary>A parameter stays empty in Revit</summary>

The Revit parameter must exist before import, and the value must match its type. See [Parameters in Revit](/beam/beam-for-rhinoceros/parameters.md#parameters-in-revit).

</details>

## RAY and Rhino inside Revit

<details>

<summary>Rhino Inside Revit install was detected.</summary>

Rhino.Inside.Revit and BEAM both load Rhino into Revit, and only one can do it per session. Launch Rhino from Rhino.Inside.Revit first, then run RAY.

</details>

<details>

<summary>The file 'opennurbs_private.manifest' required to run Rhino inside Revit was not found</summary>

An Autodesk or Revit update can remove this file. Run the BEAM installer again to restore it.

</details>

<details>

<summary>Some required BEAM components are missing or incomplete.</summary>

This can happen after a Revit update or a new Revit install. Run the BEAM installer again.

</details>

<details>

<summary>Rhino is installed. A newer Rhino is recommended to run inside this version of Revit.</summary>

Update Rhino. Revit 2025 and later work best with Rhino 8.32 or later. See [RAY requirements](/beam/installing-beam.md#ray-requirements).

</details>

<details>

<summary>The RAY and RHINO buttons are greyed out</summary>

No supported Rhino version is installed for this Revit version. Revit 2019 to 2024 need Rhino 7 or 8. Revit 2025 and later need Rhino 8. RAY is not available in Revit 2018.

</details>