You create farms using the Farms page.

Note: The RDS-enabled image is also referred to as an RDS host or an RDSH (Remote Desktop Services Host) image.


Verify that you have at least one image listed on the Images page, that image has an RDS-enabled Windows server operating system, the Images page shows that image is in Published state, and that image is located in the node in which you want to create the farm. You cannot create a farm in a node without such an image available in that node.

Decide whether this farm will serve session-based desktops or remote applications.


  1. In the Administration Console, navigate to Inventory > Farms.

    Farms page in the Administration Console

  2. Click New.
    The New Farm wizard opens.
  3. In the wizard's Definition step, complete the fields and make your selections as appropriate and then click Next.
    Note: You might have to use the scroll bar to see all of the required fields.
    Option Description
    Name Enter a name for this farm.
    Description Enter an optional description.
    Farm Type Specify the type of asset this farm will provide to end users:
    • Select Desktops to use this farm to provide session-based desktops.
    • Select Applications to use this farm to provide access to remote applications. After an applications farm is created, you can use the New Application workflow's Auto-scan from Farm option to import applications from the farm's servers into your application inventory.
    Pod This option only displays if your data center is configured with multiple pods.

    Pods contain specific assignable images and server model capacities for assignments. You can only create assignments from images in the same pod.

    Network If your data center is configured to use specific network mappings to assignments, select the network that you want this farm to use. For example, if you have a DHCP server on a specific network and your data center is configured to use that network for assignments, you would select that network.
    Note: If Load Balance value is selected, no specific network mapping will be used for the assignments using on this farm.
    Image Select the assignable RDSH image.
    Preferred Protocol Select a default display protocol you want the end user sessions to use.

    Circumstances might occur that cause another protocol to be used instead of the default protocol. For example, the client device does not support the default protocol or the end user overrides the default protocol selection.

    Preferred Client Type Select the preferred client type used when end users launch their session-based desktops from the Workspace™ ONE™ platform's portal, either a Horizon Client or a browser for HTML Access.
    Domain Select the Active Directory domain registered with your environment.
    Join Domain Select Yes so that the farm's server instances are automatically joined the domain when they are created.
    Servers Specify the number of servers you want in this farm.
    Sessions per Server Specify the number of concurrent end user sessions per server that this farm will allow.
    Important: In this release, you cannot update this number after the farm is created. As a result, you must choose judiciously the value you select here.
    Optionally configure the advanced properties.
    Option Description
    VM Names Name for all of the server VMs created for this farm, which will have a number appended to it, for example, win2016-1, win2016-2, etc. The name must start with a letter and can contain only letters, dashes, and numbers.
    Computer OU Active Directory Organizational Unit where the server VMs are to be located. For example, OU=RootOrgName,DC=DomainComponent,DC=eng, and so on. The entries must be comma-separated with no spaces in between.

    If you need to use nested Organization Units, see Working with Nested Organizational Units

    Run Once Script (Optional) Location of scripts that you want run after system preparation completes.
    Session Timeout Interval This is the amount of time the end users' sessions can be idle before the system forces a log off from the session-based desktops or applications that are served by this farm. This timeout applies to the logged-in session to the underlying Windows operating system. This timeout interval is separate from the timeout settings that govern the end users' Horizon Client or HTML Access logged-in session.
    Caution: When the system forces the log off in the underlying Windows operating system session, any unsaved data is lost. To prevent an unintended loss of data, set this interval high enough to accommodate the business needs of your end users.
    Note: If no user activity occurs before the timeout interval is reached, a message indicates that the user will be logged off if they do not click OK in the next 30 seconds. If the logoff occurs, any unsaved user data, such as documents or files, is lost.
    Enable Windows Hot-Plug (Optional) Keep the default No setting to prevent end users from dynamically adding or removing external devices from their virtual desktops, such as CD/DVD drives, Ethernet adapters, and similar device types.
    Caution: Setting this toggle to Yes can result in users accidentally interfering with connectivity to the virtual desktops if the users dynamically remove the networks cards (NICs) or other operational components by mistake. Even though you might choose to enable this setting for special cases, such as supporting the use of thumb drives in your virtual desktops, be aware that the setting is enabled for all such plug-and-play devices in the resulting desktops.
  4. In the wizard's Management step, complete the fields and make your selections as appropriate and then click Next.
    Option Description
    Rolling Maintenance Select the maintenance type, either according to a time cadence (Scheduled) or based on user sessions to this farm's servers (Session).

    When Scheduled is selected, configure the maintenance cadence, either daily or weekly. If you choose a daily recurrence, specify the hour at which the maintenance will start. If you choose a weekly recurrence, specify both the day of the week and the hour.

    When Session is selected, specify the number of sessions at which the farm should begin rolling maintenance.

    Note: Sessions which are logged off within 15 minutes are not counted for the purposes of the rolling maintenance calculations, to prevent restarting or rebuilding the servers based on a count of short running sessions.

    In the Concurrent Quiescing Servers field, specify the number of servers that can be in the quiescing state at the same time. When a server is in quiescing state, the server continues to work for the user sessions already connected to that server, but it does not accept any new user connections.

    Server Action Select the action that the system should perform on the servers undergoing maintenance.
    • With Restart, the server VMs are restarted.
    • With Rebuild, the server VMs are first deleted and then reprovisioned from their RDS desktop image.
    Timeout Handling Configure how you want the system to handle certain types of user sessions.
    Note: The user sessions governed by these settings are the user logins to the Windows operating system session of the RDS session desktop or application. These sessions are not the user logins in Horizon Client, Horizon HTML Access, or Workspace ONE.

    The user's session begins when the user authenticates to the Windows operating system that underlies the session-based desktop or the remote application that is served from this farm's servers.

    • Empty Session Timeout - For applications farms, select how the system should handle idle user sessions, whether to never timeout idle sessions or to timeout after a specified number of minutes. Idle timeouts are based on the activity on the endpoint device, not on the session-based desktop or application. If you specify to timeout an idle session, select what happens when the timeout period is up: whether to disconnect the session or log the user off. When a session is disconnected, the session is disconnected from the network and preserved in memory. When a session is logged off, the session is not preserved in memory, and any unsaved documents are lost.
    • Log Off Disconnected Sessions - Select when the system logs the user off of a disconnected session.
    • Max Session Lifetime - Specify the maximum number of minutes the system should allow for a single user session.
  5. In the wizard's Summary step, review the settings and then click Submit to begin creating the farm.


The system starts creating the farm. You can monitor the progress using the Activity page. When the farm's status shows a green dot on the Farms page:

  • If you created a desktops farm, you can use it to create a session-based desktop assignment.
  • If you created an applications farm, you can use it to load applications from the servers' underlying RDS-enabled operating system into your Horizon Cloud applications catalog.

Farms in ready state on the Farms page

What to do next

If you created a desktops farm, you would next create a session-based desktop assignment for your end users by following the steps in Create an RDSH Session Desktop Assignment.

If you created an applications farm, you would next scan that farm to load applications into Horizon Cloud and then create an applications assignment so your end users can use the remote applications from that farm.

For more information, see Applications, Importing New Applications from an RDSH Farm Using Auto-Scan from Farm, and Manually Adding Custom Applications from an RDSH Farm.