Incomplete documentation for Azure VPN connection for Linux

Bharath Kumar (C) 20 Reputation points
2025-10-23T10:59:55.8+00:00

I want to connect to an Azure VPN (P2S) using Entra from Ubuntu 22.04, which the documentation states is supported: Azure VPN Client for Linux.

The documentation lists three steps:

Download and install the Azure VPN Client for Linux.

Import the client profile settings into the VPN client.

Create a connection.

I have installed the Azure VPN Client:

dpkg -l | grep vpn
ii  microsoft-azurevpnclient 3.0.0 amd64 Azure VPN Client

In step 2, the documentation shows GUI instructions to import the profile, but I do not have a GUI on Ubuntu 22.04 — I only have CLI access.

My questions:

Is importing the VPN client profile supported via CLI on Ubuntu 22.04?

If yes, what is the procedure and which client should be used to perform the import?

  1. Has anyone tested this successfully on CLI-only Ubuntu 22.04?
Azure ExpressRoute
Azure ExpressRoute
An Azure service that provides private connections between Azure datacenters and infrastructure, either on premises or in a colocation environment.
0 comments No comments
{count} votes

Answer accepted by question author
  1. Ganesh Patapati 10,460 Reputation points Microsoft External Staff Moderator
    2025-10-23T13:42:19.7533333+00:00

    Hello Bharath Kumar (C)

    Apologies for the Inconvenience caused here,

    Please note that configuring the Azure VPN Client with Microsoft Entra ID authentication for Linux is currently in the preview stage. When a service or feature is in preview, some functionalities may be limited, unstable, or subject to change. Certain constraints or unsupported configurations can lead to unexpected errors.

    Refer: https://v4.hkg1.meaqua.org/en-us/azure/vpn-gateway/point-to-site-entra-vpn-client-linux?source=recommendations

    NOTE: CLI import and connection for Entra ID is not supported yet.

    Workarounds

    • If you need CLI-only: Use OpenVPN with certificate-based P2S profiles or set up a minimal GUI environment for the official client.
      or
    • Editing the .xml profile and using OpenVPN for cert-based auth.

    Refer this Article:https://v4.hkg1.meaqua.org/en-us/answers/questions/2281040/azure-vpn-client-doesnt-work-on-ubuntu-22-04-%28bugf-------------------------------------

    As this something which is not supported. We encourage customers to create a feedback item for this request on the feedback forum

    Forum: Azure Networking Feedback Forum · Community


    I hope this was helpful!

    If the above is unclear or you are unsure about something, please add a comment below.

    If these answers your query, do click the "Upvote" and click "Accept the answer" of which might be beneficial to other community members reading this thread.

    1 person found this answer helpful.
    0 comments No comments

1 additional answer

Sort by: Most helpful
  1. Bharath Kumar (C) 20 Reputation points
    2025-10-30T04:20:09.5366667+00:00

    When is this feature expected to be released in production ?


Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.