Collaborate through KeyVR Connect

KeyVR Connect makes it possible for multiple users to experience a scene in VR together.


  • All participants must be on the same LAN. You may use a VPN to connect to the network from a remote location. Note that if a VPN is used, all participants should connect to the LAN via VPN.

  • All participants must launch the same version of the scene, either locally or from a shared folder.

How to start a session

  1. Start KeyVR.

  2. On the computer you wish to host the session, open the scene that you want to share.

  3. When the scene has opened, press the Host Session button.

  4. Once the connection has been established, a session code will appear.

  5. Share the code to those you want to invite to join the session.

We recommend that you make the scene, you want experience together, available to all participants via the shared folder option described below - to make sure all are using the exact same scene.
If you are not able to access the same shared folder for the scene, you may want distribute both the session code and the scene file itself. It is recommended to create a .ksp package in KeyShot, so that all the necessary resources (such as textures) are part of the file itself, and will be shared along with the scene. If you plan to view the baked version of the scene, it is also a good idea to share the baking cache (filename.bake, located next to the scene file). This way, each user does not have to generate their own baking cache.

How to join a session

  1. Start KeyVR.

  2. Press “Join session”.

  3. Enter the session code and press Connect.

    1. The session code is provided by the session host.

  4. Locate the scene that the host has used if KeyVR can not find it automatically. It is important that you use the exact same scene as the host is using.

    1. It is also possible to use a shared scenes folder - see below.

  5. You will then load into the hosted scene and join the session automatically.

Setting up a shared scenes folder

  1. Open KeyVR.

  2. Press “Join Session”.

  3. Press “Preferences…”.

  4. Next to the “Shared scenes:” line, press the “Choose…” button.

  5. Locate the folder in which the shared scenes would be put.

    1. We recommend using a network location, to which all participants have access.

  6. Press “Select Folder”.

  7. Finally, press “OK” to save the preferences.

Troubleshooting connection issues

If you find that you are unable to connect to the server, please try the following:

  1. Go to File > Preferences…

  2. Setup the following network settings:

    1. Set “Network” to your primary network adapter. Note: Having the wrong adapter selected is a very common source of error.

    2. Set “Local port” to “4444”.

    3. Set “Server” to “Default”.

  3. Check that port 4444 is open in your Firewall settings. The KeyVR installation process will try to open this port for you.

If you are using a VPN, all participants should to connect to the LAN via the VPN. Most network setups do not allow for having one participant in the LAN and another connected via VPN.

If you still find that you are unable to connect, please contact Support at