Quickstart: Choose a tenant and claim your device

Important

This is the Azure Sphere (Legacy) documentation. Azure Sphere (Legacy) is retiring on 27 September 2027, and users must migrate to Azure Sphere (Integrated) by this time. Use the Version selector located above the TOC to view the Azure Sphere (Integrated) documentation.

Every device must be "claimed" into an Azure Sphere tenant. Claiming the device associates its unique, immutable device ID with your Azure Sphere tenant. The Azure Sphere Security Service uses the device ID to identify and authenticate the device.

For more information, see Manage tenants.

Important

These instructions use the Azure Sphere (Legacy) interface to manage your Azure Sphere devices. If you are setting up Azure Sphere for the first time, we highly recommend that you use the new Azure Sphere (Integrated) interface which has many new features. Navigate to this page to continue setting up your Azure Sphere device via Azure Sphere (Integrated).

Important

Currently, a few early Seeed Azure Sphere MT3620 Development Kits require a manual update. If you have a kit that has never been used, update the OS manually now so that you can log in, claim your device, and connect your device to the internet. If you have any other type of dev kit (including the Seeed MT3620 Mini Dev Board), or if you have already used your Seeed Azure Sphere MT3620 Development Kit, the OS will be updated as soon as you connect the device to the internet; manual update is not required.

Prerequisites

  • Quickstart: Install the Azure Sphere SDK for Windows or for Linux.
  • In order to create a tenant, you must have an unclaimed device that has not previously been used to create a tenant.

Sign in to Azure Sphere

  1. Connect your device over USB.

  2. Open a command-line interface using PowerShell, Windows Command Prompt, or Linux command shell.

  3. Sign in to Azure Sphere, using a Microsoft account:

    azsphere login
    

    If you've never logged in to Azure Sphere (Legacy), this will initially fail, and you will need to follow instructions to register your Microsoft account before this will work.

Tip

If your browser does not open after typing azsphere login, use azsphere login --use-device-code to obtain a code. Enter this code at https://microsoft.com/devicelogin to complete the login process.

Choose a tenant

After successful login, you'll need to choose a default Azure Sphere tenant. To list available tenants, use azsphere tenant list.

  • If you don't have access to any tenants, you'll need to create a tenant.
  • If you have access to one or more tenants, you'll need to select one. See azsphere tenant select for details. After you select a tenant, proceed to the next step.

Claim the device

Important

  • Claiming a device is a one-time operation that you cannot undo even if the device is sold or transferred to another person or organization. A device can be claimed only once. Once claimed, the device is permanently associated with the Azure Sphere tenant.
  • Record the username you used to claim the device and the tenant you claimed it into.
  • You must have Administrator or Contributor permissions to claim a device in the Azure Sphere tenant.

Claim your device. After you claim your device into a tenant, you cannot move it to a different tenant.

azsphere device claim

You should see output like this:

Claiming device.
Successfully claimed device ID '<device ID>' into tenant '<name>' with ID '143adbc9-1bf0-4be2-84a2-084a331d81cb'.

Next steps

See also

Manage tenants

Tenant CLI reference