Follow these three simple steps to deploy a Visual WebGui application:

1. Register the Visual WebGui extension you will be using, as a recognized extension of your IIS. By default this is *.wgx, but it can as well be *.ashx or any other available extension.
   * If you would like to use a different extension for Visual WebGui applications, view this article here. In the case you use an ASP.NET extension will not need to to register it as it is already registered.
   * You can find IIS version specific articles linked in the "Deploy to IIS" section below, explaining how this should be done.
   * In IIS7, make sure you remember setting the extension so that you clear the "Invoke handler only if request is mapped to".
2. Visual WebGui has no deployed phisical files specific to Forms, as the applications are contained within a *.dll file.
   In IIS v5.1 and v6, there is a setting in the "Extension Mapping" dialog called: "Check that file exists". You need to uncheck this checkbox, otherwise your application will not load in deployment.
   In IIS7 this setting is unchecked by default.
3. Manually copy the following to your Virtual Directory: 
   * The "bin" directory (without the contained assembly related *.pdb and *.xml files).
   * The "Web.config" file. This file is not copied by the MS Visual Studio "Publish" action and is absolutely critical for deployment.
   * The "Resources" directory (if exists).

As an alternative to step 3, you can use the MS Visual Studio 'Publish' tool.
Do be aware that this tool will not copy the Web.config file in most cases, so you will need to copy it manually.

General concerns when deploying your Visual WebGui application to IIS

1. On IIS7 64bit with .NET4.0 installed for example you you have four different mappings registered to this extension: .NET2.0 32 bit, .NET2.0 64bit, .NET4.0 32bit and .NET4.0 64bit.
   You will need to register the mapping that suits your .NET version used by your Visual WebGui application.
   You can register more than one handler mapping for the same extension, using different handler mappings, and the one most suitable will be selected upon request.
2. When assigning your application to an application pool, you must select an application pool that you have set for the correct version of the .NET framework. For Visual WebGui application built in Visual Studio 2005 or Visual Studio 2008, you would set your application to use the v2.0 of the .NET framework, and for application built in Visual Studio 2010, you would set the application pool to use the v4.0 of the .NET framework.
3. Currently, Visual WebGui assemblies are compiled for 32bit only, which means that running it on 64bit IIS, you need to set the application pool's properties such that it allows 32bit application.
   This setting is within the advanced settings of the application pool, named "Enable 32 bit applications".
4. You may also have the option of setting your application pool's Managed Pipeline Mode, and the options are either Classic or Integrated. Visual WebGui applications have their web.config by default set for Classic mode, and to use them in Managed Mode (Integrated) you will need to make minor changes to your web.config.
   See the forum threads section below for a link to more information. Please also note that in IIS7 and newer, the DefaultAppPool (which users most often choose by default) is in Integrated mode, so to use your Visual WebGui application without changing web.config during deployment, then use the "Classic .NET AppPool", or the equivialent .NET 4.0 one.
5. If you are using a proxy server / load balancer / firewall, you may want to look at the configuration options listed in this article here.
6. If you would like more information on the various Visual WebGui related configuration options in the Web.Config file, please view this article here.
   

Upgrading a Visual WebGui version for a deployed application:

In this situation you need to replace the Visual WebGui assemblies in the bin directory of your Virtual Directory and possibly update your Resources folder. Please follow either the manual or the Publish methods for deployment above, to replace the assemblies and update your Resources folder.

• Deploying .NET 4.0 applications using IIS 7.x
• Deploying a Silverlight application including DHTML info (includes IIS6 setup info)
• Setting up and deploying to IIS7
• Setting up and deploying to Server 2008 R2 32/64 bit
• Making IIS 5.1 Visual WebGui ready
• Deploying to IIS 64 bit and (possibly) required web.config changes
• Deploying 64bit assemblies on 64bit platform
• Deploying ASP.NET applications
• Deploying ASP.NET applications - tutorial, including setup projects

• Deployment of DHTML Visual WebGui application with different extension than the standard .WGX

• Best Hosting?
• Deployment information for GoDaddy hosting
  • Walkthrough kind of discussion on deploying to GoDaddy
  • Deploying NET4.0 to GoDaddy Requires Grid Hosting Subscribtion and some special settings
  • Sample NET3.5 application with requirePermission=False settings in web.config required for GoDaddy deployment
• Deployment information for WebHost4Life hosting
• Turning GZipCompression Off for when going through an ISA server
• Find what exception was thrown on IIS7 with non-classic pool, when all you get is single character in upper left corner
• Changes required for web.config when using DefaultAppPool instead of Classic .NET AppPool
• IIS 6.0 & "Unrecognized attribute 'targetFramework'. Note that attribute names are case-sensitive."
• Targeting .NET 3.5 framework from a VS2010 application - manual steps required

• Application pools on IIS7, Integrated (DefaultAppPool) or Classic (Classic .NET AppPool)

• Configuration for Mono 2.2 deployment
• Deploying on Mono
• Supported frameworks on Mono
• How to make Apache run ASP.NET and ASP.NET 2.0
• Apache2 config file changes for mod_mono and Visual WebGui
• Deploying Visual WebGui 6.0.4, FrameWork 2.0 to Linux + Mono
• Visual WebGui will support NET3.5 (VS2008) deployment on Mono when Mono adds support for MS .NET 3.5

• Video tutorial: How to create 2 in 1 application
• Updated information on required web.config settings and required contents on Resources folder
• Controls from Gizmox.WebGui.Forms.Office and Extended do not work on 2 in 1 applications
• Adding HomeDirectory to app.config on the client application to point to the correct folder

• Cassini Desktop Adapter
• Cassini first introduced on the forums
• ScreenCast and code sample on how to use Cassini with Visual WebGui
• ScreenCast on Cassini Desktop Adapter in Seamless mode
• More Cassini screencasts at Geniuscode.net
• Develop in Visual WebGui and deploy to web and desktop

• Determining runtime what extension your application is using for deployment
• Visual WebGui Extensions in Deployment
  

• VWG-6234 - Run VWG application with less then full trust level