Connecting the Zixi Receiver (Zixi Receiver UI)

Owned by israel drori (Unlicensed)
Last updated: 07 Jun 2020 by Eli Pielet (Writec) (Unlicensed)
3 min read

For each Zixi Receiver component that has been configured in ZEN Master, you will need to configure the connection of the Zixi Receiver (using its Zixi Receiver UI) to ZEN Master. This will enable the actual connection, using the configured SSH keys. This can either be done manually by entering the configuration settings into the Zixi Receiver UI, or automatically using the ZEN tab in the Zixi Receiver UI (for v12 Receivers).

If you are using an SSH Key that was imported from the Receiver (not generated in ZEN Master) then you will need to use the manual method to connect the Receiver to ZEN Master and not the automatic method.


To connect the Zixi Receiver Manually (for v11 and below):

  1. In the ZEN Master UI, in the main navigation, click Receivers.
    The Receivers screen opens.
  2. Select the Receiver that you would like to connect.
  3. In the Details tab at the right side of the screen, click on the download link for the SSH Key.

  4. In the Configuration section you will find your personal connection configuration settings for use with Receivers Version 1.11 and older. You will be using these settings to connect the Zixi Receiver (host, username, and remote source port), so you should write them down or keep this browser tab open while you configure the Zixi Receiver.

    In tab view, you need to select the Configuration tab. In accordion view, scroll down to the Configuration section.

  5. Login to the Zixi Receiver UI (it could be a locally installed Zixi Receiver, e.g. http://localhost:4200 or a remote Zixi Receiver).
  6. Go to Settings > SSH Tunnels.
  7. In the Key File field, click Upload Key and select the downloaded SSH key file.
  8. In the Host field, enter the host name that appeared in the Configuration Help.
  9. In the Username field, enter the username name that appeared in the Configuration Help.
  10. Click Apply.
  11. In the Reverse Tunnels section (at the bottom) click Add.
    The Tunnel Details dialog opens:

  12. In the Remote Source Port field, enter the Remote Source Port that appeared in the Configuration Help.
  13. Click OK.
  14. In ZEN Master, in the main navigation, click Receivers.
    Verify that the status of the newly connected Zixi Receiver has changed from Pending to OK.


To connect the Zixi Receiver Automatically (for v12 and above):

  1. Login to the Zixi Receiver UI (it could be a locally installed Zixi Receiver, e.g. http://localhost:4200 or a remote Zixi Receiver).
  2. Click the ZEN tab.
    The ZEN login screen is displayed.
  3. In the Account ID field, enter the customer domain of your ZEN Master account (e.g. if you login to ZEN at demo.zen.zixi.com then your Account ID is 'demo').
  4. In the Email field, enter the username for your ZEN Master account.

  5. In the Password field, enter the password for your ZEN Master account.

  6. Click Login.
    A list of Receivers configured in ZEN Master is displayed.
  7. For the Receiver that you are adding, which should currently be in Pending mode, click Select.
    Details about the Feeder are shown in the Status section.
  8. Click Refresh.
    The connection is configured automatically.
  9. Verify that the Status is shown as On.
  10. In ZEN Master, in the main navigation, click Receivers and check that the status of the newly connected Zixi Receiver has changed from Pending to OK.