Search Results for

# 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

## Related reference pages

- AjaxUploaderConfig
- AjaxUploaderHandler
- LicenseService