Setting up a new Umbraco project

When setting up a new project I have the following requirements:

  • I want the project to sit in a project folder on my D drive. I don't want to work on projects in the inetpub folders.
  • I want to use flat/directory URL's.
  • be able to run multiple sites on one instillation.
  • Running on Vista with IIS7 locally. Deployed to server running IIS7.
  • If the site is to include a blog then I want it set up as a subdomain (e.g.
  • Using .NET 3.5

This is a little bit more manual the default installtion procedure. These are the steps I go though (Takes about 10 minutes):

1. Get the latest version of Umbraco and copy to a folder <projectname>/web

2. Create a new database and setup in <projectname>/DB. Add my development umbraco user to the DB

3. Setup IIS:

-  Add entries to the hosts file for URL's i am using during development e.g: fairlieagile blog.fairlieagile

- In IIS I have an application pool setup that uses .NET 2.0 and integrated pipelines

- Right click on Sites and add a new website. In the hostname give it the hostname you have entered into the hosts file

- Save and start the website

- if you are using additional host names e.g. for a blog subdomain then click on your site, go to bindings and add the details

4. Go to and get the web.config file to use with .NET 3.5 (It's also woth havign a read of "Install guide for Umbraco on 3.5 and integrated pipeline".)

5. Edit web.config

enter in the connection string details for your DB

<add key="umbracoUseDirectoryUrls" value="true" />

under <system.webserver> all umbaco's httpmodules are listed. Due to the way IIS process extensionless urls, you need to add: runAllManagedModulesForAllRequests="True" to the modules element, so it looks like this: <modules runAllManagedModulesForAllRequests="True">

6. Edit Config/UmbracoSettings.config


7. Browse to your site and run throught he isntallation process

8. Install the excellent multiple file upload package from

  • Download package from Latest version is 1.1
  • Do to developer -> packages -> Install local package
  • Follow the steps in the installer
  • Add the following to your web.config:
    <add verb="*" name="MultipleFileUploadHandler" path="MultipleFileUploadHandler.axd" type="noerd.Umb.DataTypes.multipleFileUpload.MultipleFileUploadHandler, noerd.Umb.DataTypes.multipleFileUpload" />
  • Apply the quick fix discussed here and here

Other things you might like to do:

Increase the uplaod size:

<httpRuntime maxRequestLength="10240" />

For umbraco 4.1.1 there was an encoding problem. This might help:

Edit Config/UmbracoSettings


Edit Config/tinyMceConfig.config

Change enity encoding to "named". This resolves a problem with a strange hex value (FFFD) being inserted into empty paragraphs since moving to 4.1.1.

<config key="entity_encoding">named</config>


I have few question for you. it is great appriciate that you answered them when you are appropriate.
1. I have a virtual machine hosted by some other SP, it means that I have no right to install any system software, ie. AJAX extension, on the virtual machine, I only can put my web application into the root folder of IIS6. Is it possible to deploy Umbraco in this case? I tried, but failed,

2. The database, VistaDB seems work well, I wonder is some limitation about this database?

to @jeasonzhao
1.It can deploy under IIS6, you just need to put all the required assemblies under /Application/bin and set the .NET version on 2.0
2.There's no limitation on VistaDB, the only limits of VistaDB is 500,000 records every table.