405 Error When Saving Content Items on IIS Due to WebDAV Module Interference - Missing documentation

[eb-88]

What type of issue is it? (Choose one - delete the others)

Missing documentation

What article/section is this about?

https://docs.umbraco.com/umbraco-cms/fundamentals/setup/server-setup/iis

Describe the issue

Description:

After a fresh installation of Umbraco on IIS, I encountered a 405 error when attempting to save content items. The issue was traced back to the WebDAV module, which was intercepting and blocking certain PUT requests that Umbraco relies on for saving content.

Steps to Reproduce:

1. Install Umbraco on a new IIS setup.
2. Deploy on a Windows Server with IIS
3. Attempt to save a content item.
4. Notice that a 405 HTTP error is returned.

Expected Behavior:

Content items should be saved successfully without any HTTP errors.

Actual Behavior:

The PUT requests required for saving content are being blocked by the WebDAV module, resulting in a 405 error.

Workaround:

The issue can be resolved by disabling the WebDAV module in the web.config file.

I applied the following changes:

<modules runAllManagedModulesForAllRequests="false">
    <remove name="WebDAVModule" />
</modules>

Additional Information:

Umbraco Version: 15.1.1.14
IIS Version: 10
Environment: Windows Server 2022 21H2 20348.1366 / .NET 9

It may be beneficial to update the documentation or configuration templates for IIS deployments to note that the WebDAV module can interfere with Umbraco’s functionality.

[eb-88]

One could, of course, also consider uninstalling the WebDAV module, but not everyone would want to do that.

[sofietoft]

Thanks for the report @eb-88 !

I'll make sure we look into this as soon as possible.

[eshanrnh]

Hi @eb-88 👋,

Thank you for raising this issue. It seems that the 405 error you're encountering when saving content items in Umbraco is due to the WebDAV module blocking PUT requests. This is not a problem in all IIS setups, as I was unable to replicate the issue on my end due to the WebDAV module not being installed on my system.

However, I understand how this can be an issue for others who have WebDAV installed/enabled. We’ll add a workaround/Note to the documentation to help users facing the same problem.

Thanks again for bringing this to our attention.