Deployment And Licensing

This guide covers the practical setup details that matter when an AjaxUploader Web Forms app is published.

Minimal deployment checklist

  1. Put AjaxUploader.dll in the site's bin folder.
  2. Register the ajaxupload.axd handler in Web.config.
  3. Make sure the temp upload folder exists or can be created.
  4. Set request-size limits that match your expected upload size.
  5. Install ajaxuploader5.lic for non-localhost environments.

Web.config example

<configuration>
  <appSettings>
    <add key="AjaxUploader.TempDirectory" value="~/App_Data/UploaderTemp" />
    <add key="AjaxUploader.MaxFileSize" value="524288000" />
    <add key="AjaxUploader.ChunkSize" value="5242880" />
    <add key="AjaxUploader.EnableResume" value="true" />
  </appSettings>

  <system.web>
    <httpRuntime targetFramework="4.8" maxRequestLength="512000" />
    <pages>
      <controls>
        <add assembly="AjaxUploader" namespace="AjaxUploader.Controls" tagPrefix="au" />
      </controls>
    </pages>
  </system.web>

  <system.webServer>
    <handlers>
      <add name="AjaxUploader" path="ajaxupload.axd" verb="*"
           type="AjaxUploader.AjaxUploaderHandler, AjaxUploader"
           preCondition="integratedMode" />
    </handlers>
    <security>
      <requestFiltering>
        <requestLimits maxAllowedContentLength="524288000" />
      </requestFiltering>
    </security>
  </system.webServer>
</configuration>

Embedded client assets

AjaxUploader.dll embeds the client files and serves them through the handler:

  • ajaxupload.axd/resource/js
  • ajaxupload.axd/resource/css

That means a normal Web Forms deployment does not need separate published ajaxuploader.js or ajaxuploader.css files.

Optional compatibility assembly

For a clean v5 application, AjaxUploader.dll is enough.

Only add CuteWebUI.AjaxUploader.dll when an older upgraded project still expects the old assembly name at runtime.

License file locations

The Web Forms runtime searches for ajaxuploader5.lic in these locations:

  • site root
  • bin\ajaxuploader5.lic
  • licenses\ajaxuploader5.lic
  • App_Data\ajaxuploader5.lic

You can also point to a specific file with:

<add key="AjaxUploader.LicenseFile" value="D:\Licenses\ajaxuploader5.lic" />

Local development behavior

License detection is bypassed on:

  • localhost
  • 127.0.0.1
  • ::1

That means developers can test locally without seeing the unlicensed notice while still keeping real license validation for deployed environments.

Useful appSettings keys

Key Purpose
AjaxUploader.TempDirectory Temp upload folder
AjaxUploader.MaxFileSize Max file size in bytes
AjaxUploader.AllowedExtensions Global extension allow-list
AjaxUploader.ChunkSize Chunk size in bytes
AjaxUploader.HandlerPath Handler path, default ~/ajaxupload.axd
AjaxUploader.EnableResume Enables resumable uploads
AjaxUploader.TempFileExpiryMinutes Temp cleanup threshold
AjaxUploader.MaxFilesPerUpload Global file-count limit
AjaxUploader.LicenseFile Explicit license file path