Skip to main content

Create a support tunnel

VKB-1030How-to
📦 Applies to
Xen Orchestra
🗓️ Created
2026-05-26
🔄 Updated
2026-05-26
🏷️ Tags
#support#tunnel#xoa#cli

Environment​

  • A Xen Orchestra Virtual Appliance (XOA).
  • The tunnel can be opened from the web UI, or from the CLI if the web UI is not working.

Procedure​

From the web UI​

You can open a secure support tunnel so our team can remotely investigate on your XOA. For that, we need to get the "support ID". Go into the "XOA" left menu, in the support tab, and see below:

(screenshot not migrated)

From the CLI​

If your web UI is not working, you can also open the secure support tunnel from the CLI. To open a private tunnel (we are the only one with the private key), you can use the command xoa support tunnel like below:

root@xoa
# xoa support tunnel
The support tunnel has been created.

Do not stop this command before the intervention is over!
Give this id to the support: 40713

Give us this number, and we'll be able to access your XOA securely. Then, close the tunnel with Ctrl+C after your issue has been solved by support.

TIP

  • The user xoa-support is used by the tunnel. If you want to deactivate this bundled user, you can run chage -E 0 xoa-support. To reactivate this account, you must run chage -E -1 xoa-support.

Verification​

The command reports "The support tunnel has been created." and displays the support ID to give to the support team. Do not stop the command before the intervention is over.

Related articles