Image Resizeredit page on GitHub

Installing the ImageResizer via NuGet

NuGet is a package manager for .NET, and a pretty good one. It's easy to set up, and friendly to use.

The ImageResizer is published as a NuGet package, as are nearly all of the plugins. If you have NuGet installed, you can right-click on your project and choose "Add Library Package Reference". Search for "ImageResizer", and you should see a list of packages. Click Install, and you're done. You can install plugins with similar ease, but it's always good to check the plugin's documentation to see if additional steps are required for activation.

ImageResizer or ImageResizer.WebConfig ?

If you want to manually modify Web.Config, install the ImageResizer package. Otherwise, you can install the ImageResizer.MvcWebConfig package, which will install ImageResizer, then add the HttpModule and ConfigurationSection registration elements to Web.Config, and install MvcRoutingShim. If you are only running .NET 2.0, install ImageResizer.WebConfig insted.

The WebConfig package never deletes anything from your Web.config file, but it may duplicate elements if you have already installed the changes in a slightly different manner.

The WebConfig package is used by most of the sample packages.

If you're using ASP.NET MVC, you can install ImageResizer.MvcWebConfig to get everything working in one step.

Don't worry! All packages can be safely combined!

Full list of available packages

The following is a list of NuGet packages available for V3.1.

Click here for the list on nuget.org that may be more up-to-date

Packages denoted with [1] require a Performance Edition license or higher. Packages denoted with [2] require a Creative or Elite edition license Packages denoted with [3] require an Elite edition license.

Please note most Essential Edition plugins are contained in the core package ImageResizer

The Faces, FreeImage, and Security plugins do not yet have NuGet packages.

  • ImageResizer
  • ImageResizer.WebConfig
  • ImageResizer.Mvc
  • ImageResizer.MvcWebConfig
  • ImageResizer.Plugins.DiskCache [1]
  • ImageResizer.Plugins.PrettyGifs [1]
  • ImageResizer.Plugins.AnimatedGifs [1]
  • ImageResizer.Samples.Jcrop
  • ImageResizer.Plugins.S3Reader [1]
  • ImageResizer.Plugins.Watermark [2]
  • ImageResizer.Plugins.SimpleFilters [2]
  • ImageResizer.Plugins.AzureReader [1]
  • ImageResizer.Plugins.AzureReader2 [1]
  • ImageResizer.Plugins.AdvancedFilters [2]
  • ImageResizer.Plugins.RemoteReader [1]
  • ImageResizer.Plugins.SqlReader [1]
  • ImageResizer.Plugins.PsdReader [3]
  • ImageResizer.Plugins.CloudFront [1]
  • ImageResizer.Plugins.PdfRenderer
  • ImageResizer.Plugins.SeamCarving [2]
  • ImageResizer.Plugins.WhitespaceTrimmer [2]
  • ImageResizer.Plugins.BatchZipper [3]
  • ImageResizer.Plugins.Wic [2]
  • ImageResizer.Plugins.Logging
  • ImageResizer.Plugins.PsdComposer [3]
  • ImageResizer.FluentExtensions (third-party)
  • ImageResizer.FluentExtensions.Mvc (third-party)
  • ImageResizer.Plugins.MongoReader [3]
  • ImageResizer.Plugins.WebP [2]
  • Imazen.WebP

Package Manager Console

The Package Manage Console can be opened in Visual Studio through `Tools`>`Library Package Manager`>`Package Manager Console`

PM> Install-Package ImageResizer.MvcWebConfig
PM> Install-Package ImageResizer.Plugins.DiskCache
PM> Install-Package ImageResizer.Plugins.PrettyGifs
PM> Install-Package ImageResizer.Plugins.SimpleFilters

NuGet GUI (Visual Studio)

  1. Right-click on your project and click "Manage NuGet Packages".
  2. Select "NuGet Offical Package Source"
  3. Search for "Imazen", using the search bar at the top right
  4. Select "ImageResizer Web.config Installation (with MVC support)" and choose Install
  5. Repeat for each desired plugin

View available packages on NuGet

More details about NuGet installation

  1. Add ImageResizer.dll, ImageResizer.Mvc.dll, ImageResizer.Plugins.DiskCache.dll, and any other plugin dlls you wish to use to the /bin folder of the website. If you're using Visual Studio, right click your project and choose "Add Reference" for each of these files instead.

  2. Modify or create the /Web.Config file for your site. Make sure all these elements are added correctly (You may wish to make a backup of Web.config first).

     <?xml version="1.0" encoding="utf-8" ?>
 <configuration>
   <configSections>
     <section name="resizer" type="ImageResizer.ResizerSection,ImageResizer"  requirePermission="false"  />
   </configSections>

   <resizer>
     <!-- Unless you (a) use Integrated mode, or (b) map all reqeusts to ASP.NET, 
          you'll need to add .ashx to your image URLs: image.jpg.ashx?width=200&height=20 -->
     <pipeline fakeExtensions=".ashx" />

     <plugins>
       <add name="MvcRoutingShim" />
       <add name="DiskCache" />
       <!-- <add name="PrettyGifs" /> -->
       <!-- <add name="SimpleFilters" /> -->
       <!-- <add name="S3Reader" /> -->
     </plugins>  
   </resizer>

   <system.web>
     <httpModules>
       <!-- This is for IIS5, IIS6, and IIS7 Classic, and Cassini/VS Web Server-->
       <add name="ImageResizingModule" type="ImageResizer.InterceptModule"/>
     </httpModules>
   </system.web>

   <system.webServer>
     <validation validateIntegratedModeConfiguration="false"/>
     <modules>
       <!-- This is for IIS7+ Integrated mode -->
       <add name="ImageResizingModule" type="ImageResizer.InterceptModule"/>
     </modules>
   </system.webServer>
 </configuration>

  3. Start your web site, then visit /resizer.debug.ashx to verify you've done everything correctly. If you ever encounter issues, simply revisit that page to access the self-diagnostics. If you need help, just ask!

  4. Ready to go live? Get the Performance Edition, which includes disk caching and several other invaluable plugins.

  1. If Web.config already exists in the target website or application, use the Manual Installation Method.
  2. Copy the contents of the Samples\BasicIISSite\ folder of the download into the new website.
  3. Browse to the web site and type '/resizer.debug.ashx' directly after the domain or IP address. You should get a page of diagnostic information if everything is working. If you need help, just ask!
  4. Copy ImageResizer.Plugins.DiskCache.dll from \dlls\release\ in the download to \bin in the target application, and un-comment the DiskCache line in Web.config. Repeat for all desired plugins.