This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(259.20000000000005, 63%, 35%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3EDB%3C/text%3E%3C/svg%3E)
I would like to upload an image to Azure, however it fails, after latest SDK update.
$ azsphere image add --image zsas.imagepackage
The command failed with an unexpected error. Here is the traceback:
No module named 'azure.sphere.dotnet'
Traceback (most recent call last):
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/knack/cli.py", line 233, in invoke
cmd_result = self.invocation.execute(args)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azure/cli/core/commands/__init__.py", line 666, in execute
raise ex
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azure/cli/core/commands/__init__.py", line 733, in _run_jobs_serially
results.append(self._run_job(expanded_arg, cmd_copy))
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azure/cli/core/commands/__init__.py", line 725, in _run_job
return cmd_copy.exception_handler(ex)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azure/sphere/cli/core/cloud_exception_handler.py", line 189, in cloud_exception_handler
raise ex
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azure/cli/core/commands/__init__.py", line 703, in _run_job
result = cmd_copy(params)
^^^^^^^^^^^^^^^^
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azure/cli/core/commands/__init__.py", line 336, in __call__
return self.handler(*args, **kwargs)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azure/cli/core/commands/command_operation.py", line 121, in handler
return op(**command_args)
^^^^^^^^^^^^^^^^^^
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azext_sphere_cloudmanagement/image/custom.py", line 97, in add_image
check_valid_beta_api_use(file_path, force)
File "/opt/azurespheresdk/Tools_v2/lib/python3.12/site-packages/azext_sphere_cloudmanagement/utils.py", line 13, in wrapper
import azure.sphere.dotnet.app_package
ModuleNotFoundError: No module named 'azure.sphere.dotnet'
I could not find any solution.
Running on Ubuntu. Nothing changed. After SDK update, the command was not working anymore. All other features or functions are working. Please help me out.
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(176, 16%, 27%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3ESC%3C/text%3E%3C/svg%3E)
Hi David Boross,
Did you get any chance to review the above response. Do let me know if you have any further queries.
Thank you!
I reinstalled the SDK several times, and it did not solve the issue.
$ azsphere show-version
----------------
Azure Sphere SDK
================
25.04.515235
----------------
Hello David Boross,
Welcome to Microsoft Q&A,
Thank you for sharing the details and for confirming that reinstalling the SDK did not resolve the issue. Based on your environment (Ubuntu + Azure Sphere SDK 25.04.515235) and the error:
No module named 'azure.sphere.dotnet'
this is not a setup issue on your side. It is a known regression in the Azure Sphere 25.04 Linux SDK.
What’s actually happening
In SDK 25.04, the Linux package no longer includes the Python module:
azure.sphere.dotnet
However, the azext_sphere_cloudmanagement extension still tries to import it when running image-related commands such as:
azsphere image add
azsphere image update
Because the module is missing from the Linux SDK, the image upload path fails every time, even after a clean reinstall.
This is why your reinstall did not help the dependency isn’t shipped at all.
Workarounds that currently work
1. Use the Azure Sphere Build Environment (Docker)
Microsoft’s official container still includes the older working module.
Run:
docker run -it mcr.microsoft.com/azure-sphere-build-env
Inside the container:
azsphere image add --image zsas.imagepackage
This bypasses the broken SDK on Linux.
2. Use the Windows Azure Sphere SDK
The Windows version still includes the required module, and image uploads work normally.
3. Use the Azure Sphere REST API
Since the classic CLI has been retired, make sure to use the Azure Sphere Integrated CLI for the latest features and fixes.
Image upload can be done programmatically without the CLI:
POST /v1/images/upload
This avoids the invalid Python import entirely.
4. Roll back to the last working Linux SDK (24.x)
If your workflow must run on Ubuntu, you can temporarily downgrade:
sudo apt-get install azsphere=24.xx.xxxxx
Replace with the latest 24.x version you previously used.
Root Cause
Linux SDK 25.04 removed azure.sphere.dotnet.
The CLI extension still references it.
This mismatch breaks all image-management commands on Linux.
You didn’t misconfigure anything this is a confirmed SDK packaging issue. Until the patched SDK is released, the most reliable options are:
If the issue arose after an SDK update, consider rolling back to a previous version that was working for you. You can find older versions on the Azure Sphere Downloads page.
Also please Review known issues related to the SDK update in the release notes.
I Hope this helps. Do let me know if you have any further queries.
Thank you!