This guide outlines the process of running Peregrine with a Cloud Zoo license. Find out more on Cloud Zoo Licenses on McNeel. If you are looking to upgrade an existing license to use Cloud Zoo, or if you encounter difficulties, please email us at licensing@limitstate.com.

Step 1. Install Peregrine

  • Make sure you have the appropriate version of Peregrine installed.

Step 2. Login into your Rhino3D account

Step 3. Start Grasshopper

  • Type Grasshopper into the command line or click the Grasshopper icon in the user interface:

 
Rhino 7 interface - Starting Grasshopper by typing "Grasshopper" into the command window
Rhino 7 interface - Starting Grasshopper by clicking the Grasshopper icon in the Rhino toolbar
 

Step 4. Drag the Peregrine License component on to the canvas

The Peregrine license component, showing that a "Free" license is active

Step 5. Open the context menu and switch to a “Cloud Zoo” license

  • Right-click the component to bring up the context menu and select Cloud Zoo.

The Peregrine Licensing dialog. Context menu open and mouse over "Cloud Zoo" option.
  • Peregrine will attempt to fetch a license from Rhino Cloud Zoo.

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

4-NoLicenseDialog.png

Step 6. Add your license key

6-AddLicense.png
  • Select where the license is to be stored and enter the key that you have been sent by email.

  • Use Personal Licenses if installing an individual license for personal use.

  • Use Team Licenses if installing for a company or institution. Team licenses can be shared amongst any group of people.

  • Click Add License.

Step 7. Fetch the license

  • Go back to Grasshopper and click Try Again in the Licensing dialog. This will load the license from your Cloud Zoo account.

8-TryAgain.png

Step 8. Check the license status

  • In Grasshopper, connect a panel to the License component, or hover over it. The panel will display the status of the license.

Peregrine Licensing dialog with Panel attached. Panel text shows that a Cloud zoo license is active.

Step 9. Check the license on Cloud Zoo (optional)

  • In your Rhino account, select the Peregrine license to display details of the type and expiration date.

CheckLicense.png