Getting Started

[fa icon="plus-square"] Why do I need a Connection Broker?
The Leostream Connection Broker provides the tools you need to deliver and manage end-user resources hosted in the data center and cloud efficiently and securely, including virtual machines, cloud-hosted desktops, physical workstations, HPE Moonshot Systems, applications, printers, and more. The Leostream Connection Broker allows you to use the best technology to satisfy your users' needs, including mixing and matching different virtualization vendors and different display protocols, while integrating with your existing infrastructure.
[fa icon="plus-square"] How do I obtain a trial license?

You can obtain a 30-day trial license, as follows:

  • Go to
  • Click on the Free Trial link at the top-right side of the page.
  • Enter your contact information and click Submit.

Leostream will send an email to the email address entered in the Free Trial form, with instructions on how to download the Connection Broker. After you install your Connection Broker, contact Leostream sales at +1 781-890-2019 x710 to obtain your trial license.

[fa icon="plus-square"] Where do I download the Connection Broker?
Click here to go to the Leostream downloads page. See the Leostream Installation Guide for instructions on installing the Connection Broker.
[fa icon="plus-square"] What ports does the Connection Broker use for communications?
The Connection Broker uses different ports to talk to different systems. See "Connections to External Systems" in the Connection Broker Application Guide for a diagram of all ports used by the Connection Broker.   
[fa icon="plus-square"] How do I configure my Connection Broker?

How you configure your Connection Broker – defining your authentication server, creating desktop centers, building pools, plans, and policies, and assigning policies to users – depends on your environment. See the Tutorials page for step-by-step setup guides that are most appropriate for your deployment.



[fa icon="plus-square"] How do I install my Connection Broker?
The Connection Broker is packaged as an application that installs on a Linux operating system. The Installation Guide describes the installation steps. 
[fa icon="plus-square"] Why do I need the Leostream Agent?
The Leostream Agent communicates with the Connection Broker to provide information about when a user logs out of, disconnects from, or locks their remote session. In addition, the agent implements the Leostream end-user experience enhancements, including managing USB device passthrough, network printer redirection, and multi-monitor support.

Common Setup Questions 

[fa icon="plus-square"] How do I enable advanced features in my Connection Broker?
Not all features are turned on, by default. Your Leostream license key controls the functionality you see in your Connection Broker. If you need access to different types of centers, display protocols, provisioning, or any other feature, please contact to have the feature added to your license.
[fa icon="plus-square"] What do Leostream terms like pools and policies mean?

See Getting Started with Leostream Concepts for information about Leostream terminology and for a general description of what happens when a user logs into Leostream.



[fa icon="plus-square"] What if I have an authentication server other than Active Directory?

The Connection Broker can authenticate users against Active Directory, NIS, and any authentication server that uses the standard OpenLDAP format. Use the Type drop-down menu to correctly set default values for the different types of supported authentication systems.

See "Chapter 5: Integrating with Authentication Servers" in the Connection Broker Administrator's Guide for complete instructions on adding the different types of authentication servers to your Connection Broker.

Adding Centers

[fa icon="plus-square"] Why do I need to add Centers?
The Connection Broker communicates with Centers to inventory and manage the resources you need to deliver to your users. If you do not create any centers, you cannot offer desktops, applications, or printers to your users. See "Chapter 6: Connecting to your Hosting Platform" in the Connection Broker Administrator's Guide for information on what types of Centers you can create and complete instructions.

Clients and Locations

[fa icon="plus-square"] When do I need to set up Locations?
Leostream Locations allow you to provide the user with different Roles and Policies based on the physical location of the user's client device. In addition, Locations allow you to tailor the user's experience by attaching different printers, setting registry keys, changing display plans, using different protocols, etc., based on where the user is located. For a complete description of how to set up and user locations, see "Chapter 13: Configuring User Experience by Client Location" in the Connection Broker Administrator's Guide.
[fa icon="plus-square"] How do I change the Connection Broker address in Leostream Connect when the client is installed on Windows 7?

After installing Leostream Connect, you must run Leostream Connect as a user with administrator rights if you need to modify the Connection Broker address. Windows 7 requires elevated privileges to run Leostream Connect as an administrator.

To run Leostream Connect with the required privileges on Windows 7:

  1. Right-click on the Leostream Connect icon on the desktop
  2. Select Run as Administrator
  3. If necessary, enter administrator credentials

After Leostream Connect launches, you can access the Options dialog via the System Tray menu and change the Connection Broker address.


[fa icon="plus-square"] How do I setup a Protocol Plan to connect to a Linux desktop?

You can connect to a Linux desktop from either a Windows or Linux client.  If connecting from a Linux client, install the Java version of Leostream Connect on the client device.

To define a protocol plan to use when connecting to Linux desktops:

  • Go to the > Configuration > Protocol Plans page.
  • Select Edit for the protocol plan.
  • In the Leostream Connect and Thin Clients Writing to the Leostream API section, select the appropriate number from the Priority drop-down menus for each of the protocols that can be used to connect to a Linux desktop.
  • Enter appropriate information in the Command line parameters and Configuration file fields.
  • Set the Priority drop-down menu for all other protocols, such as RDP, to Do not use
Note: If you are connecting to a Windows machines from a Linux client, ensure that you set the Priority for rdesktop to 1, and the Priority for RDP to Do not use.