# 1.2.1 Cloud Licenses

Guide to running Karamba3D with a cloud license. Find out more on [Cloud Zoo Licenses](https://wiki.mcneel.com/rhino_accounts/home) on McNeel.

{% hint style="info" %}
If you are looking to upgrade an existing standalone or network to the cloud, please email us at <license@karamba3d.com>.
{% endhint %}

## **Installation**

### 1. Load License

Make sure you have Karamba3D for Rhino6 or above [installed](https://manual-2.karamba3d.com/a.2-installation#standard-installation).

Type "**Karamba3DGetLicense"** in the Command line

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2F305cbc692d8e12b48c1eb805f8f3057b6c7c0dba.PNG?generation=1595316031920280\&alt=media)

### 2. Login into your Rhino3D account

Login to your account at Rhino3D account. Cloud licenses are available on McNeel's [Cloud Zoo Licensing](https://www.rhino3d.com/en/6/new/licensing-and-administration#cloud-zoo) platform. Create an [account ](https://accounts.rhino3d.com/help)if you have not already done so.

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2F8afa693f8cde7494248ac5e46d313d190ea1a1e0.PNG?generation=1595316031431700\&alt=media)

### 3. Fetch license

Karamba3D will try to fetch the license from the cloud.

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2Fcfe74a9c004a480baaf576dddeb96542cdbe4974.PNG?generation=1595316032163041\&alt=media)

If this it the first time installing a license, there will be no license found. Click **Add a License** to add your license.

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2F05509019baaf512c588f7727c15c944fde94dada.PNG?generation=1595316032227656\&alt=media)

### 4. Add License

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2F9a20ce1ecca2a9e01b8b161e28181ae0780b4acf.PNG?generation=1595316031735720\&alt=media)

* use Personal Licenses if installing an individual license for personal use
* use [Team Licenses](#create-a-team) if installing for a company or institution. Team licenses can be shared amongst any group of people.

### 5. Enter the License Key

You will have received an email with the license key.

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2F3fa6533c01b3bbf59899118bba76ab0ffe09e2f5.PNG?generation=1595316032663673\&alt=media)

### 6. Check License Details

Click on **View License Details** to see information about the license. It will display the type of license, the number of seats and the expiration date of the license.

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2F23dfa9d50b52e9536d734d4c5dbec94e2010a094.PNG?generation=1595316031928744\&alt=media)

### 7. Add License

Click **Add License** and the license should be added to your account.

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2Fc1a4ba22660856d3fa8fe5ec5b4a5d6cad8690b3.PNG?generation=1595316032373515\&alt=media)

### 8. Check License

Click on the license to check the status of the license

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2Fc9301dc3aadf12c33b1e9f272439ce6f583381f2.PNG?generation=1595316031636036\&alt=media)

### 10. Fetch License

Go back to Rhino3d and click **Try Again** in the Licensing Window

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2Fc0a73cda8c6300b6c9a8b722d6e442ca49b5aa58.PNG?generation=1595316032151078\&alt=media)

### 11. License Loaded

The license will load and upon successful activation, the license information will be displayed in the Command Line

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2F61842246a3e9e7fa9b9062afd57302341ec617a8.PNG?generation=1595316032485994\&alt=media)

### **12. Check License Status**

Open Grasshopper and place the **"License"**-component onto the grasshopper canvas and connect a panel to it. The panel displays the status and expiration of the license.

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2Fa09a4a9c6e66fa9a3ffe5b33876e2372fc05726a.jpg?generation=1595316030547776\&alt=media)

### 13. Load License upon Startup

The license has been successfully installed.

Every time you open Rhino, you need to type **Karamba3DGetLicense** to load the license each time. This needs to be done before opening Grasshopper.

### 14. Automate License Load

The Karamba3D license can simply be loaded by typing "**Karamba3DGetLicense"** each time Rhino loads, but this process can be automated in the **Tools/Options -> Rhino Options/General**..

Type "**Karamba3DGetLicense"** into the **Command Lists** textbox. The license will then be automatically loaded upon opening Rhino.

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2Faad0c68df0ac00ca6cb278b85ae44a1db88217a6.PNG?generation=1595316032045176\&alt=media)

{% hint style="danger" %}
Make sure to run the "**Karamba3DGetLicense"** command before opening Grasshopper otherwise the license will not be activated.&#x20;
{% endhint %}

## Releasing the License

When pulling the license from the cloud for the first time, Rhino temporarily holds the license for a few days for offline use. You can manually release the license by logging out of your Rhino account. This will also release your Rhino license.

{% hint style="info" %}
To release the license, you will need to logout of your account by typing **"logout"**.&#x20;
{% endhint %}

## **Check License**

Restart Rhino and your license should run.

Upon successful installation of the license you should be able to open example files which have more than 20 beam elements or 50 shell elements. Double check if the license and correct Karamba3D version are installed by opening the below definition:

{% file src="<https://442610158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MCkDlhlZpqUmakSqOrp-2335387569%2Fuploads%2FkKMxaBp2dFdOQMAs12wf%2FLicense%20test.gh?alt=media&token=c9a09928-c6b5-4527-9313-0a36af79f506>" %}

![](https://442610158-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MCkDlhlZpqUmakSqOrp%2Fsync%2F667180dfbf17fde90a97ed36f138f4401727086e.jpg?generation=1595316029110996\&alt=media)

## Account administration

### Account Settings

You can log into your [Rhino ](https://accounts.rhino3d.com/?controller=home)account to administer licenses and set up teams.

### Create a Team

If you intend to share licenses with a other users, make sure to create a [Team ](https://accounts.rhino3d.com/?controller=groups)and add the licenses to the team. Read more on [McNeel](https://wiki.mcneel.com/rhino_accounts/create_team).

### License Management

You can check the [licenses ](https://www.rhino3d.com/licenses?controller=home&_forceEmpty=true)installed on your personal or team accounts. All licenses can be administered here and live-usage can be checked.

### Add licenses

You can add licenses by logging into your cloud account and proceed to the [Add Licenses](https://www.rhino3d.com/licenses/?controller=add_licenses) page. Read more on [McNeel](https://wiki.mcneel.com/rhino_accounts/add_licenses).
