Connecting Azure
Link your Microsoft Azure account to Zynnode using an ARM template.
Zynnode connects to Azure using an ARM (Azure Resource Manager) template. This template sets up the necessary permissions so Zynnode can deploy to Azure Virtual Machines on your behalf. No manual credential configuration is needed.
Prerequisites
- A Microsoft Azure account with an active subscription
- Permission to create resource deployments in the Azure Portal
Step-by-Step Setup
Start the Connection in Zynnode
During the new project wizard, select Azure as your cloud provider. You'll see a setup screen with two actions:
- Download Configuration — Downloads a JSON configuration file (
zynnode-azure-setup.json) - Open Azure Portal — Opens the Azure Portal in a new tab
Click Download Configuration first to save the file to your computer.
Open the Azure Portal
Click Open Azure Portal (or go to portal.azure.com manually). Then:
- In the Azure Portal search bar at the top, type Deploy a custom template and click the result.
- On the Custom Deployment page, click Build your own template in the editor.
Upload the Zynnode Template
- On the template editor page, click Load file at the top.
- Select the
zynnode-azure-setup.jsonfile you downloaded from Zynnode. - The editor will populate with the template contents. Don't modify anything.
- Click Save at the bottom of the editor.
Configure the Deployment
After saving the template, you'll be taken to the deployment configuration page:
- Subscription — Select your Azure subscription from the dropdown.
- Resource Group — Choose an existing resource group or click Create new and give it a name like
zynnode-resources. - Region — Pick the region closest to your users.
- Leave any other fields at their default values.
- Click Review + create.
Review and Create
- Azure will validate the template. Wait for the green Validation passed message.
- Review the summary to make sure everything looks correct.
- Click Create.
Azure will take 1–3 minutes to complete the deployment.
Return to Zynnode
Switch back to the Zynnode tab. Zynnode automatically checks every few seconds for the new connection. Once Azure finishes the deployment, Zynnode will detect it and show a green checkmark.
You're now connected to Azure and can proceed with your deployment.
If you've already connected Azure in a previous project, Zynnode will detect the existing connection and skip this step automatically.
What Does the Template Create?
The ARM template creates a service principal and role assignment in your Azure subscription. This grants Zynnode the permissions to:
- Create and manage Virtual Machines
- Configure networking rules (ports, IPs)
- Deploy your application to the VM
Zynnode never stores your Azure account password. All access goes through the scoped service principal.
Troubleshooting
Validation failed in Azure
- Make sure you selected a valid subscription with available quota.
- Check that you have permission to create resource deployments. If you're on a company account, you may need to ask your Azure admin for Contributor role access.
Zynnode isn't detecting the connection
- Make sure the deployment in Azure shows Succeeded status (not still running).
- Try refreshing the Zynnode page. The automatic check runs every 5 seconds.
- If it times out after 5 minutes, go back to the previous step in Zynnode and restart the Azure setup.
I want to disconnect Azure
To remove the Zynnode connection from your Azure account:
- Open the Azure Portal.
- Navigate to Resource Groups.
- Find the resource group you created for Zynnode (e.g.,
zynnode-resources). - Click Delete resource group and confirm.
- In the Zynnode dashboard, remove the Azure connection card.