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.

Cisco RoomOS logo on the left and Microsoft Teams Rooms logo on the right with the word OR in between.

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).

List titled 'Things you will need' with four requirements: same network as device, device admin credentials, device IP address, and JIBB License (API key), above a Cisco device with camera.
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:

Login page for app.jibb.ai/admin with options to continue with Google, WebAuthn, or by entering email and password, plus a sign-up link.
Please note: You will need to have a JIBB Admin/Owner account to access the JIBB Admin Portal.
JIBB Admin Portal web page showing the Users tab with one user listed and an arrow pointing to the Macro Devices tab with instruction to navigate there.
Admin Portal interface showing step 3 to add a device named 'Meeting Room 1' with arrows pointing from the Add Device button to the input field and Add button.
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.
Admin portal web interface showing a device list under Macro Devices tab with instruction to click the Key link beside Meeting Room 1 device.
Once you've added your device, hover over it and click on "Key" to generate a JIBB Room API Key for that device.
Admin portal screen showing a popup window to generate an API key with instructions and buttons labeled Cancel and Generate, highlighted by a purple arrow and circle indicating step 05 to click Generate.
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.
Admin portal screen showing a pop-up to generate and copy an API key with a purple arrow highlighting the copy button and text '06 Copy the API Key'.
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.
Screenshot of JIBB Admin Portal showing Macro Devices tab with devices listed by name and date added, highlighting a 'Configuration' button with an arrow and text '07 Click Configuration'.

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.

Instruction card reminding to click 'Save' with tips to check device admin credentials and JIBB API Key if the JIBB app is missing on the Room Navigator home screen.

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.

An electronic device setup including a speaker with a camera, a tablet displaying an app, and a whiteboard showing a hand-drawn bar graph with three bars labeled A, B, and C.
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.

User interface showing a new camera preset named 'jibb' being saved with a finger pointing at the Save button on a touchscreen keyboard.

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.

Headset with microphone resting on a desk alongside a keyboard, mouse, and notepad.