Orchard Documentation

Search

Contributors

Contributors

Table of Contents

Manually installing Orchard zip file

This topic targets, and was tested with, the Orchard 1.8 release.

This topic shows the steps you need to perform to install Orchard using the .zip file.

We will use three different approaches:

  • IIS.
  • WebMatrix and IIS Express
  • Visual Studio and the Visual Studio Development Server.

Note: If you prefer using the Web Platform Installer, or if you plan to use WebMatrix to develop your site, you may want to see the topic Installing Orchard, which installs Orchard from the Web Platform Installer and includes WebMatrix in the installation.

Downloading the .zip File

Navigate to the Downloads Section of Orchard in Codeplex.

You will find two .zip files.

  • Orchard.Web.1.x.xx.zip : In this file the site has already been built and can be run without additional compilation. It does not includes all the source code.
  • Orchard.Source.1.x.xx.zip : This file includes the source code. If you plan to develop modules you probably prefer this one. It is easier to use with Visual Studio and you have plenty of source files to see how everything is done.

Running the Site Using IIS

This procedure was tested with a clean installation of Windows 8.1 Enterprise Edition.

First let's setup the server. Search for "Add or Remove Programs" in your system. And execute it.

Click Turn Windows features on or off.

Click Internet Information Services and then ASP.NET 4.5. Click OK.

At this point we recommend rebooting your system. This way you will be sure that all the required services are started from scratch.

When the system restarts, download the Orchard.Web.1.x.xx.zip file from here. Extract the .zip file to your Desktop. The extracted folder contains several files and an Orchard folder. Copy the Orchard Folder to C:\inetpub\wwwroot\.

In Windows Explorer go inside the Orchard Folder.Let's start with App_Data folder.

This folder is where Orchard stores site settings. Right-click App_Data folder, click Properties and using the Security tab set modify and read permissions for the IIS_IUSRS user.

Then repeat the same procedure for the following folders:

  • Modules. This is required if you want to install modules from the gallery. (We recommend that you remove the read/write permissions for production sites.)
  • Themes. This is required if you want to install themes from the gallery. (We recommend that you remove the read/write permissions for production sites.)
  • Media. This folder is where Orchard stores media files (images, etc.).

Tip: If you want to completely reset an Orchard site configuration to its default settings, you can delete the contents of the App_Data directory. This removes all your custom settings, users, and configuration, as well as any custom data you have added to the site. If you delete the contents of the App_Data folder, and if you want to remove custom images that you have added to the site, you can delete the contents of the Media folder as well. The required files will be recreated the next time Orchard is started.

Now you can create your new website. Search your system for Internet Information Services (IIS) Manager, and execute it.

Click in Default Web Site and stop. This will free port 80 for our site.

Right-click Sites and Add Website.

Write your site name and point Physical path to your Orchard folder. Click Ok.

Click Yes in the warning dialog about two sites using port 80.

Your website is running now. Click browse to navigate to it.

You should see the Orchard setup screen in your browser.

Running the Site Using WebMatrix and IIS Express

Download the Orchard.Web.1.x.xx.zip file from here. Extract the Orchard .zip file to a local folder. Launch WebMatrix, and in the Quick Start screen, click Open and then Folder.

Navigate to the folder where you extracted the .zip file, select the folder named Orchard, and then click Select Folder to open the site.

To run the site, in the WebMatrix Files workspace, select the root Orchard folder. Click the drop-down list in the Run button and then select a browser.

You should see the Orchard setup screen in your browser.

Running the Site Using Visual Studio and the Visual Studio Development Server

This procedure was tested with Visual Studio 2013 Update 1.

Altough you can run the precompiled version of Orchard in Visual Studio, you will find much easier to work in Visual Studio with the full source code version. Download the full source code from here. Extract the .zip file to a local folder.

Launch Visual Studio and select File > Open > Project/Solution. Navigate to the folder where you extracted the .zip and open the folder named src. Select the Orchard.sln solution file.

To run the site, press Ctrl+F5. You should see the Orchard setup screen in your browser.

Setting Up a Site

When you first launch the Orchard site, you are presented with 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. The database and user specified in the connection string must be created before you start the Orchard setup. Optionally, you can enter a table prefix so that multiple Orchard installations can share the same database but keep their data separate.

The Orchard setup screen includes a section where you can choose an Orchard recipe. 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 are now on the Orchard home page and can begin configuring your site.

Change History

  • Updates for Orchard 1.8
    • 4-9-14: Added screenshots and more detail to the IIS section. Updated Webmatrix screenshots. Changed a bit the structure of some paragraphs to make them clearer. Updated some links.
  • Updates for Orchard 1.6
    • 11-07-12: Updated screens for 1.6 installation.
    • 4-12-11: Updated screens for 1.1 installation.
    • 3-14-11: Added section on using WebMatrix and IIS Express.
    • 3-14-11: Added information about recipes in the setup screen.
    • 3-15-11: Fixed the IIS section to use the Orchard subfolder from the zip.