User Guides > JIBB Room > Cisco Device Installation

How to Install JIBB Room on a Cisco Device

This guide walks you through installing the JIBB Room App on Cisco Room Series devices using the JIBB Admin Portal.

1. Compatibility Requirements

Please make sure you check all of the following details before you start installing JIBB Room on your Cisco Device:
Important: Network Firewall/Proxy Health Check

As a crucial first step to ensure that your network environment is optimized for seamless integration, we recommend doing a quick network health check.

Step 1: Check JIBB Workspace Accessibility

Visit the Login Page:

  • Open your web browser on a desktop connected to the same network as your Cisco Device and go to https://app.jibb.ai/.
  • If you see the login page, proceed to Step 1. This indicates that your network allows access to JIBB Room, but it does not confirm full accessibility.
  • If you see a blank or error page, this could mean that your network settings, including firewalls or proxies, are blocking access to JIBB Room.

Step 2: Verify JIBB Room API Accessibility

Access Developer API Tab in Local Device Controls:

  • Log in to Webex Control Hub.
  • Local Device Controls for the device you want to install JIBB Room onto.
  • Inside Local Device Controls, click on the Developer API tab.

Execute the following API Command:

“xCommand HttpClient Get ResultBody: None Url: https://app.jibb.ai/”

Interpret the Results:

  • A message showing "1 of 1 applied successfully" with a green tick signifies that your network isn't blocking JIBB, and you can proceed with the installation of JIBB room. 
  • A response of "some commands were rejected" suggests that JIBB is likely being blocked by your firewall or proxy settings.

Step 3: Adjust Firewall / Proxy Settings

If either Step 1 or Step 2 indicates that JIBB Room is being blocked:

  1. Whitelist Essential Domains:
  • Ensure the following domains are whitelisted in your firewall and proxy settings to allow smooth operation of JIBB Room on your network:
    • https://app.jibb.ai/
    • https://api.jibb.ai/
  1. If you're not sure how to adjust these settings, contact your IT administrator:
  • Provide them with the domains listed above and request that they ensure these are not blocked by your network’s firewall or proxy.

1.1 - Device Operating System Requirements

JIBB Room is fully compatible with Cisco Devices running on both the latest Cisco RoomOS Stable Channel and Microsoft Teams Rooms (MTR) mode. Whether you prefer the native Cisco experience or the MTR interface, JIBB Room works seamlessly with your setup.

Key Points to Ensure Compatibility:

  • Latest Software Versions: Ensure your device is updated to the latest version of RoomOS/MTR Stable Channel for optimal performance and compatibility.
    • How to Check: In Control Hub under Devices > Software, you can see the different channels and how many devices in your organization are on which OS/channel.

1.2 - Network Settings & Device Admin Credentials

Whenever you want to install JIBB Room on a device or update the App's configuration, please ensure you are connected to the same network as the device.

You also need to have access to an active device admin username and password/passphrase, the device's IP address, and a valid JIBB Room license API key (more info below).

Accessing & Managing Local Device Usernames & Passwords:

You need an active local device admin username and password to install JIBB Room onto your Cisco device.

Confirm you have an active local admin username, password, and IP address for your Cisco device, and you're connected to the same network as the device. This step is crucial for a smooth installation.

To access, create, or update a local user with an active admin role for your device, follow these steps:

  1. Log in to https://admin.webex.com.
  2. Go to Devices and select your device in the list.
  3. Launch Local Device Controls and go to Users.
  4. Add a new user and assign the admin role and set the status as Active.

2. Installing the JIBB Room App

Once you have checked the compatibility requirements above, you're ready to start installing JIBB Room onto your Cisco Room Series Device.
Attn: Demo License Users

If you're installing JIBB Room using a demo license key, you will need to refer to the Demo License Installation Guide, which follows a different process.

Please follow the instructions below to login to the JIBB Admin Portal, add a device, generate a JIBB Room API Key and complete the configuration form to install the JIBB Room App on your Cisco Device:

Please note: You will need to have a JIBB Admin/Owner account to access the JIBB Admin Portal.
Tip: If your device already has a name, such as "Board Room Camera 1", use the same name here in the JIBB Admin Portal so you know which devices you have already installed the JIBB Room App onto.
Once you've added your device, hover over it and click on "Key" to generate a JIBB Room API Key for that device.
Please note: If you generate a new API key for a device you have already added and installed JIBB Room onto, the old API Key will no longer be valid, and you will need to reinstall the App with the new API Key you generated.
Tip: It is highly recommended that you copy this API Key into a secure location, such as a Word document, as you will no longer be able to re-access it once it is copied and this window is closed.

3. Post Installation

After installing the JIBB Room App on your device, follow these instructions to test the app or make any changes.
3.1 - Make sure you clicked 'Save'

When using the configuration form to install JIBB Room, always remember to click "Save" when you're done, so the app is installed correctly.

If you encountered any errors, please review the steps above or contact support@jibb.ai.

If you can’t see JIBB Room on the Room Navigator home screen: 

Check your JIBB Room API Key or generate a new one.

3.2 - Check the Room Navigator

You'll know JIBB Room is installed when the JIBB Room App icon is added to the Room Navigator touchscreen (or inside the Control Panel if your device is running on MTR mode).

If you are updating the app after it's already installed, you'll see a "JIBB is ready" notification appear on the Room Navigator.

3.3 - Removing JIBB Room from your device

If you've already installed JIBB Room using the method above and want to uninstall the app from your device so you can install it on another device using the same API Key, follow the instructions in this video.

4. JIBB Room Camera Preset

In order for JIBB Room to automatically snap to your whiteboard every time someone uses the app, we strongly recommend creating a new Camera Preset position named "jibb" on your device.
4.1 - Aim, Set & Forget

On your Room Navigator, go to the manual controls and aim the camera at the meeting room whiteboard, zoom in or out, making sure it fits the whole writing surface inside the camera preview that will be displayed on the TV screen/monitor connected to your device.

You must name this new camera preset "jibb"


Make sure you tap "Save". Once installed, the JIBB Room macro will use this preset to ensure that every time someone starts JIBB Room on the device, the camera will automatically snap to the whiteboard.

Watch the tutorial video to see how it's done.

If you're using a Device running on MTR mode, please watch and follow the instructions in the tutorial video below.

Still Need Help?

If you didn’t find the answer here or need help with something more specific, our support team is ready to assist. Use the options below to get personal support or raise an issue.