Requirements for Local Cursor and Keyboard

The Enable Local Cursor and Keyboard settings are configured from the user interface Features tab.

There are requirements for the local cursor and keyboard feature. If the Enable Local Cursor and Keyboard checkbox is grayed out, ensure the following requirements are met:

  • The PCoIP host and zero client both use the same firmware that supports local cursor and keyboard.
  • The Host Driver Function option is enabled on the PCoIP host and the PC or workstation is restarted after changing the option.
  • A PCoIP session is established between the PCoIP host and client.
  • The graphics card is not configured to scale the image (that is, not using technologies such as horizontal/vertical span mode from NVIDIA).
  • The graphics card is configured to use the monitor’s built-in scaling when a non-native resolution is selected.
  • If xrandr version 1.1 or lower is installed on the workstation, the display(s) are not rotated.
  • If using firmware release 4.1.0 or higher and the mouse or keyboard are connected behind a USB hub, ensure only HID devices (keyboard and mouse) are connected to the USB hub.
  • The mouse and keyboard devices function correctly with the zero client’s OSD.
  • The Enable Configuration option is selected on the OSD User Settings > Display Topology tab.
  • The resolution settings on the OSD User Settings > Display Topology tab match the resolution settings of the X Window screens.
  • If xrandr version 1.1 or lower is installed on the workstation, the correct monitor information is configured on the UI Monitors tab.
  • All active X Window monitors must be connected to one client.
  • Verify the X Window output screens match the display outputs detected by the host card. The host card reports the display outputs on the Info > Attached Devices window. To access this window, log into the host card web interface and select Info > Attached Devices.
  • X Window multi-monitor workstations can be configured to overlap screens (physical displays) such that part of the image or the entire image shown on display 1 also appears on display 2. The local cursor feature does not work in systems configured in this manner. Verify none of the X Window screens overlap each other.
  • If xrandr version 1.1 or lower is installed on the workstation, the table below shows the supported video modes and the number of monitors supported in each mode. The Local Cursor and Keyboard feature is disabled or does not function properly on systems that configure the graphics card to use unsupported video modes, or the number of monitors is incorrect.

    Supported Video Modes

    TwinView Xinedrama Number of Monitors Supported
    Disabled Enabled 1, 2, 3, or 4
    Disabled Disabled 1
    Enabled Disabled 2


    Some multi-monitor workstations using newer versions of the Nvidia driver (310.19) with Xinerama enabled must include the t option when starting the pcoip_agent. If the remote and local cursors are not in sync after starting the pcoip_agent, try adding the -t option to the HostSWOption setting in the daemon configuration file and restarting the host software.