This article walks you through registering an Epiphan Pearl device with EchoVideo. Once registered, the device can be assigned to a Room, scheduled for recordings, and monitored centrally — just like any other capture device in your EchoVideo tenant.

For an overview of the Epiphan integration, see: Epiphan Integration Overview

Prerequisites

Before beginning registration, complete the following required steps:

• Ensure the device is powered on and connected to the network.
• Ensure your workstation is connected to the same network / subnet as the device.
• Ensure your device: 
  • Is registered with Epiphan (this is separate from EchoVideo registration).
  • Is using Epiphan firmware version 4.24.5 or later.
• Have EchoVideo Administrator credentials and Configuration permissions available.

For the smoothest setup and testing experience, it is recommended to use a simple unmanaged switch and avoid VPN connections or segmented VLANs during initial configuration.

Registration Overview

1. Generate the Device Key in EchoVideo
2. Complete the Epiphan Setup
3. Validate the Device Registration in EchoVideo
4. Assign the Device to a Room

Generate the Device Key in EchoVideo

Available via two flows - one directly from the Rooms tab if you are adding a device directly to a Room - or one from the Institution's Device Keys tab, which is helpful when deploying or configuring multiple devices.

Rooms

1. In EchoVideo, navigate to the Rooms tab and create a room if you do not already have one.

2. Click ADD DEVICE TO ROOM, as shown in the image below

   

   The Add a Device modal appears.

3. Click the drop-down and select Add a new Epiphan device...., as shown in the image below.

   

4. Enter the Device Key Name and click Next to generate the unique client ID and secret for that key, as shown in the image above.

   This can be unique to each device, or you can use it across multiple devices.

5. Copy the Client ID and Client Secret and store them securely (e.g., in a password manager or secrets vault). You will need these during the Epiphan Setup.
6. Continue with Epiphan Setup.

Device Keys

1. In EchoVideo, navigate to Institution Settings > Configuration > Epiphan Devices, as shown in the image below.
2. Click Generate Device Key.

3. Enter the Device Key Name and click Next to generate the unique client ID and secret for that key.

   tip This can be unique to each device, or you can use it across multiple devices.

4. Copy the Client ID and Client Secret and store them securely (e.g., in a password manager or secrets vault). You will need these during the Epiphan Setup.
5. Continue with Epiphan Setup.

Epiphan Setup

Verify Firmware Version

1. From a web browser, log in to the device's Admin panel using the admin account.
2. Scroll to Configuration and click Firmware Update, as shown in the image below.
3. Click Check for updates, as shown in the image below.
4. Click Apply, as shown in the image above.

The Epiphan device will update and reboot, and the browser should auto-refresh after the firmware upgrade completes.

Install the Echo360 CMS App

Firmware version 4.24.5 and later includes the Echo360 CMS app. After the firmware update completes, the app appears under the Apps tab in the Epiphan Admin panel and must be installed and configured.

1. Scroll to Apps and click Apps, as shown in the image below.

   

2. On the Apps page, under Available, you should see the Echo360 application for the device.

3. Click Install.

   It will begin downloading and installing. It may take up to 5 minutes to complete.

4. Once completed, you will see the Echo360 app running under Installed.

Configure the Echo360 CMS App

1. Still in the Epiphan Admin panel, under the Configuration menu, click CMS, as shown in the image below.

   

2. From the Choose CMS dropdown, select Echo360, then click Apply, as shown in the image above.

   The EchoVideo modal appears, as shown in the image below.

   

3. In a separate browser tab, log in to your EchoVideo tenant as an Admin.

4. Paste the Client ID and Client Secret into the EchoVideo modal on the Epiphan > CMS configuration tab, as shown in the image below.

   

5. Click Save.

   The device is successfully registered.

   

Validate the Device Registration in EchoVideo

Rooms

1. Switch to your EchoVideo tab, then click Next in the Add a device modal.

2. Enter the Serial Number of the Epiphan Device you want to register with EchoVideo.

   Tip: This can be located in the Info section of the Epiphan Admin Configuration tab.

3. Click Validate Device, as shown in the image below.

   

4. Click Add and Configure when the Connection Successful message appears, as shown in the image below.

   

Device Keys

Device Validation is optional on the Device Keys tab and can be performed either directly on the tab or via the Key Generation workflow.

Assign the Device to a Room

Rooms

The device is automatically assigned to the Room when you click Add and Configure during validation. No additional steps are needed.

Device Keys

The device is registered with EchoVideo but not yet assigned to a Room. To assign it:

1. Navigate to the Rooms tab in EchoVideo.
2. Create a Room if you do not already have one, or locate the existing Room you want to assign the device to.
3. Click ADD DEVICE TO ROOM.
4. In the Device Selection modal, search for the device by its Serial Number.
5. Select the device and click Add Device.

After Registration

After an Epiphan device is registered and assigned to a Room, administrators configure the Room's recording Profiles to define how the device's Epiphan channels map to EchoVideo input channels.

See: Epiphan Room Configuration

Best Practices

• Use direct IP access during initial setup.
• Keep firmware current before integrations.
• Test locally before moving devices into production VLANs.
• Document device IPs, admin credentials, and EchoVideo mappings.
• Clearly label devices in EchoVideo for easier administration.