Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Quickstart - Connect a machine to Arc-enabled servers (Windows or Linux install script) description: In this quickstart, you connect and register a hybrid machine to Azure Arc using an install script. ms.topic: quickstart ms.date: 09/25/2025 ms.custom: mode-other # Customer intent: "As an IT administrator, I want to connect and register hybrid machines with Azure management tools, so that I can effectively manage and oversee my on-premises, edge, and multicloud environments." --- # Quickstart: Connect a machine to Arc-enabled servers (Windows or Linux install script) Get started with [Azure Arc-enabled servers](overview.md) to manage and govern your Windows and Linux machines hosted across on-premises, edge, and multicloud environments. In this quickstart, you deploy and configure the Azure Connected Machine agent on a Windows or Linux machine hosted outside of Azure, so that the machine can be managed through Azure Arc-enabled servers. For Linux, the installation script configures the repository on your machine and installs the Connected Machine agent package by using your package manager. If you prefer to onboard your Linux machine without an installation script, you can [manually onboard the machine by using your package manager](quick-onboard-linux.md). While you can repeat the steps in this article as needed to onboard additional machines, you can also use other options for deploying the agent, including methods designed to onboard machines at scale. For more information, see [Azure Connected Machine agent deployment options](deployment-options.md). > [!TIP] > If you prefer to try using Azure Arc-enabled servers in a sample/practice experience, get started quickly with [Azure Arc Jumpstart](https://azurearcjumpstart.com/azure_arc_jumpstart/azure_arc_servers). ## Prerequisites * An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). * Administrator permissions to install and configure the Connected Machine agent. * For Linux, use the root account. * For Windows, use an account that's a member of the Local Administrators group. * Review the [Connected Machine agent prerequisites](prerequisites.md) and verify the following requirements: * These resource providers are [registered on your subscription](prerequisites.md#azure-resource-providers): * Microsoft.HybridCompute * Microsoft.GuestConfiguration * Microsoft.HybridConnectivity * Microsoft.AzureArcData * Your target machine runs a supported [operating system](prerequisites.md#supported-operating-systems). * Your account has the [required Azure built-in roles](prerequisites.md#required-permissions). * The machine is in a [supported region](overview.md#supported-regions). * The Linux hostname or Windows computer name doesn't use a [reserved word or trademark](/azure/azure-resource-manager/templates/error-reserved-resource-name). * If the machine connects through a firewall or proxy server to communicate over the Internet, make sure that no [required URLs](network-requirements.md#urls) are blocked. ## Generate installation script Use the Azure portal to create a script that automates the agent download and installation and establishes the connection with Azure Arc. You'll install this script, in a later step, to the hybrid machine you want to onboard to Azure Arc. 1. [Go to the Azure portal page for adding servers with Azure Arc](https://portal.azure.com/#view/Microsoft_Azure_HybridCompute/HybridVmAddBlade). You can also get to this page from **Machines - Azure Arc** in the portal by selecting the **Onboard/Create** link, then selecting **Onboard existing machines**. 1. On the **Basics** page, complete the following steps: 1. Select the subscription and resource group where you want the machine to be managed within Azure. 1. For **Region**, choose the Azure region in which the server's metadata will be stored. 1. For **Operating system**, select the operating system of the server you want to connect. 1. For **Connectivity method**: 1. Choose either **Public endpoint** or **Private endpoint**. If you select **Private endpoint**, you can either select an existing private link scope or create a new one. 1. If you want to use a **Proxy server URL**, enter the proxy server IP address or the name and port number that the machine will use in the format `http://<proxyURL>:<proxyport>`. 1. If you selected **Public endpoint** and you want to use [Azure Arc Gateway](arc-gateway.md), select an existing **Gateway resource** or create a new one. 1. For **Authentication method**, select **Authenticate machines manually**. 1. Select **Next**. 1. On the **Tags** page, review the default **Physical location tags** suggested and enter a value, or specify one or more **Custom tags** to support your standards. Then select **Next**. 1. In the **Download and run script** section, complete the following steps: 1. Review the script. If you want to make any changes, use the **Previous** button to go back and update your selections. 1. Select **Download** to save the script file. ## Install the agent by using the script Now that you've generated the script, run it on the server that you want to onboard to Azure Arc. The script downloads the Connected Machine agent from the Microsoft Download Center, installs the agent on the server, creates the Azure Arc-enabled server resource, and associates it with the agent. Complete the following steps for the operating system of your server. ### Windows agent 1. Sign in to the server. 1. Open an elevated 64-bit PowerShell command prompt. 1. Change to the folder or share where you copied the script. Run the `./OnboardingScript.ps1` script to execute it on the server. ### Linux agent Install the Linux agent on the target machine by using one of the following methods: * On target machines that can directly communicate to Azure, run the following command: ```bash bash ~/Install_linux_azcmagent.sh ``` * On target machines that communicate to Azure through a proxy server, run the following command: ```bash bash ~/Install_linux_azcmagent.sh --proxy "{proxy-url}:{proxy-port}" ``` ## Verify the connection with Azure Arc After you install the agent and configure it to connect to Azure Arc-enabled servers, verify that the server has successfully connected. 1. Go to the **Machines - Azure Arc** page in the Azure portal. 1. Find the machine you onboarded and confirm that its status is **Connected**. 1. Confirm the machine has a connected status. :::image type="content" source="./media/quick-enable-hybrid-vm/enabled-machine.png" alt-text="Screenshot showing a successful machine connection in the Azure portal." border="false"::: ## Next steps * Learn how to [connect multiple machines to Azure Arc using a service principal](onboard-service-principal.md). * Understand the various [deployment options for Azure Arc-enabled servers](deployment-options.md). * [Create a policy assignment to identify non-compliant resources](tutorial-assign-policy-portal.md)