Image Resizeredit page on GitHub

Why you should upgrade to V3

  1. Over 300 bug fixes and performance enhancements that simply aren't possible with the V2 architecture.
  2. Simpler, yet far more capable API.
  3. Hundreds of new features.
  4. Free updates. V2.8 support ended on June 15, 2011. V2.X was supported for 3 years, folks.
  5. 48+ plugins are available for everything from PSD parsing to SQL or S3 backends.
  6. Simple, intuitive configuration. No more polluting <appSettings>. Go from 2 complex pages to 6 easy lines.

Upgrade now   V2 and V3 differences   Migration guide  

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.