Orchard Documentation


Table of Contents

Installing Orchard

There are four ways you can install Orchard. You can:

This topic shows how to install Orchard using the Microsoft Web Platform Installer.


The minimum requirements for running Orchard are the following: * ASP.NET 4 * A web server such as IIS Express 8, 7.5 or IIS 7.x.

When installing IIS, make sure you enable the ASP.NET IIS modules. Also make sure that you run Orchard in an integrated pipeline ASP.NET 4 application pool.

Important: If you previously installed any pre-release versions of WebMatrix, ASP.NET Web Pages, or ASP.NET MVC 4, you must uninstall those products before Orchard will run correctly on your computer. Also, if you plan to use Visual Studio 2010 with Orchard, prior to installing Orchard, install ASP.NET MVC 4 from the Web Platform Installer.

To develop Orchard sites, many developers will want to use a database such as SQL Server, and a web page programming environment such as WebMatrix or Visual Studio 2010. The following installation using the Web Platform Installer includes Orchard and IIS Express 7.5, and also includes optional applications for Orchard development, including WebMatrix and SQL Server Compact 4.0.

Installing Orchard

To begin, download and install the Web Platform Installer. When you're done, run it.

Find Orchard CMS and then click Add to include Orchard as an item to install.

Click Install. Accept the license terms in order to continue.

When the installation is complete, the dialog shows the list of installed tools in addition to Orchard. Click the Launch link to open the site in WebMatrix.

Running Orchard in WebMatrix

After WebMatrix starts, click the Files workspace to see the contents of the Orchard site. Launch Orchard in a browser by clicking the Run drop-down button, and selecting which browser to use.

When you launch Orchard in your browser, you see the Orchard setup screen.

By default, Orchard includes a built-in database that you can use without installing a separate database server. However, if you are running SQL Server or SQL Server Express, you can configure Orchard to use either of those products instead by specifying a connection string. Optionally, you can enter a table prefix so that multiple Orchard installations can share the same database but keep their data separate.

The setup screen also includes a section where you can choose an Orchard recipe to set up your site. You can choose from the following Orchard recipes:

  • Default. Sets up a site with frequently used Orchard features.
  • Blog. Sets up a site as a personal blog.
  • Core. Sets up a site that has only the Orchard framework for development use.

For information about recipes and how to make a custom recipe, see Making a Web Site Recipe.

After you've entered the required information on the setup screen, click Finish Setup. When the setup process is complete, your new site's home page is displayed.

You can now begin configuring your site.

Change History

  • Updates for Orchard 1.1
    • 4-12-11: Updated screens for 1.1 installation.
    • 3-14-11: Added information about recipes in the setup screen.