locally deploy

Preview

During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in

locally deploy

This page is part of the CLI Reference and is generated from the CLI's own help output, so it matches what locally deploy --help prints.

For more information see ARM Templates and Bicep.

locally deploy

Deploy an ARM or Bicep template to Locally.

Deploys an ARM template, or a Bicep file (using the bicep CLI on your PATH), and follows it to
completion.

The scope (resource group, subscription or management group) is read from the template's $schema.
Without flags, the default Subscription is used and the Resource Group and deployment names are
generated. A management-group-scoped template needs --management-group.

Examples:
# Deploy into a generated resource group in the default subscription
  locally deploy ./template.json

  # Deploy into an existing resource group
  locally deploy --resource-group example ./template.json

  # With an ARM parameters file
  locally deploy --parameters ./parameters.json ./template.json

  # Bicep: a .bicep template with a .bicepparam parameters file (needs 'bicep' on your PATH)
  locally deploy --parameters ./main.bicepparam ./main.bicep

  # A subscription-scoped template, recording the deployment in a chosen location
  locally deploy --location berlin ./subscription-template.json

  # A management-group-scoped template, deployed at the management group "platform"
  locally deploy --management-group platform ./management-group-template.json

  # Into a specific subscription, under a chosen deployment name
  locally deploy --subscription 00000000-0000-0000-0000-000000000000 --deployment nightly ./template.json

Usage

locally deploy [flags]

Flags

--deployment string         Name to record the deployment under (e.g. --deployment=test)
  -h, --help[=true|false]         help for deploy
      --location string           Location for a subscription-scoped deployment (e.g. --location=berlin)
      --management-group string   Management group for a management-group-scoped deployment (e.g. --management-group=some-group)
      --parameters string         Path to an ARM parameters file (e.g. --parameters=./parameters.json)
      --resource-group string     Resource group for a group-scoped deployment (e.g. --resource-group=some-group)
      --subscription string       Subscription to deploy into (e.g. --subscription=abc123)
Preview

During Public Preview you can use the Team plan for free, and get an early-adopter discount at GA. Sign in

A local cloud for you and your AI agents.

Your Azure infrastructure, running on your machine. Deploy in seconds, break things freely, and ship to Azure when you're ready.