Skip to content
  • There are no suggestions because the search field is empty.

How do I setup a VRED collaboration session with Hololight Stream Runtime?

How to configure VRED multiuser collaboration and connect XR devices through Hololight Stream Runtime

This article explains how to set up a VRED multiuser collaboration session and connect Hololight Stream Runtime so users on XR devices can join the same shared scene.

It covers:

  • Requirements for a VRED collaboration session
  • Preparing each workstation with VRED Cluster Setup
  • Starting and joining a collaboration room
  • Connecting from Hololight Stream Runtime
  • Port and network configuration

For more details on multiuser workflows, see the official Autodesk VRED documentation.

Requirements

Before setting up your session, ensure the following:

VRED version and project consistency

  • All workstations must use the exact same VRED version.
  • All workstations must have the same project loaded.
  • All workstations must be in the same network.

Recommended workstation setup

The ideal configuration is a three-workstation setup:

  • Workstation A: Hosts the collaboration server and the scene.
  • Workstations B and C: Connect to Workstation A and receive the scene.

In this example, we use only two workstations, where:

  • Workstation 1 runs the scene and also acts as the cluster server.
  • Workstation 2 runs the scene and connects as a client.
  • Both have the same project locally.

Network and port considerations

  • All workstations must be on the same network segment or connected through a routed network that allows direct communication.
  • Ensure the required VRED collaboration ports are open.
  • By default, VRED uses the following (depending on version):
    • Collaboration: Port 8889
    • Cluster services: Port 8000–8003 (TCP/UDP)
  • If ports were customized in VREDClusterSetup, use the same configuration across all workstations.

Prepare Workstation 1 (Cluster setup)

  1. Navigate to C:\Program Files\Autodesk\VREDPro-18.1\bin\WIN64
    Screenshot_VRED Multiuser Setup_1
  2. Adjust VREDPro-18.1 according to the installed version.
  3. Scroll down to VREDClusterSetup.
  4. Double-click the file (you may be prompted by Windows Security).
  5. Enter administrator credentials if required.
  6. Under Connection Rule, define a name (for example: VRED_Multi) and enable the connection rule.
  7. Under Allowed Services, enable Collaboration.
    Screenshot_VRED Multiuser Setup_2
  8. This setup typically does not need to be repeated unless settings must be changed later.
  9. Close the window.

Start a collaboration session on Workstation 1

  1. Open VRED.
  2. Open your project.
  3. In the top toolbar, select Interaction > Collaboration.
    Screenshot_VRED Multiuser Setup_3
  4. Under My Profile, define a username (for example: Multiuser_1).
  5. Under My Profile, define a room name (for example: Multiuser).
  6. All participants must use the exact same room name.
  7. Under Session, enter the IP address of Workstation 1.
  8. Select Join.
    Screenshot_VRED Multiuser Setup_4
  9. If no session exists yet, this creates the collaboration session.
  10. Use the Invite option and share the generated invite text or simply provide your workstation’s IP address to other participants.

Prepare Workstation 2 (Cluster setup)

Repeat the same Cluster Setup steps:

  1. Navigate to:
    C:\Program Files\Autodesk\VREDPro-18.1\bin\WIN64
  2. Double-click VREDClusterSetup and provide admin credentials if required.
  3. Under Connection Rule, enter a name (for example: VRED_Multi) and enable the connection rule.
  4. Under Allowed Services, enable Collaboration.
  5. Close the window.

Join the collaboration session on Workstation 2

  1. Open VRED.
  2. Open the same project used on Workstation 1.
  3. Select Interaction > Collaboration from the top toolbar.
  4. Under My Profile, define a username (for example: Multiuser_2).
  5. Enter the same room name used on Workstation 1 (for example: Multiuser).
  6. Under Session, enter the IP address of Workstation 1.
  7. Both users should now be visible within the collaboration room.
  8. Select Join.
    Screenshot_VRED Multiuser Setup_5

Join the session with Hololight Stream Runtime

  1. On both workstations, start the XR session by selecting the Hololight icon in the top-right corner.
  2. Put on your XR devices and open Hololight Stream Client.
  3. Connect the first XR device to the first workstation by entering the workstation’s IP address shown in Hololight Stream Runtime.
  4. Repeat the process with the second XR device and the second workstation.

Hololight Stream Runtime will stream the rendered VRED session from the workstation to your XR device.

Both VRED clients and the XR participant will share the same collaboration context, including navigation, annotations, and interactions.

Summary

With these steps, you can set up a multiuser VRED collaboration session and join it using Hololight Stream Runtime.

Ensuring identical VRED versions, matching projects, and consistent cluster settings across devices is essential for a smooth collaboration experience.

If you need help troubleshooting ports, connectivity, or cluster configuration, feel free to ask.