Manual Installation Recipe for IIS 7.x and .NET 4


IIS 7.x is installed, if not you can enable it from Windows feature configuration on Windows 7 Pro or Windows Server 2008 under Control Panel > Programs

.NET framework is installed, ideally .NET 4.0 (it is possible to use .NET 3.5 SP1 but in this article we will use .NET 4).

These steps assume you have at least a little familiarity with IIS and that you are able to create a database and database user in SQL Server.


1. Download the mojoPortal content management system package from our Codeplex download page

2. Extract the zip file

3. Copy the wwwroot folder to wherever you want to install it and optionally rename the folder, ie rename it to mojoportal. This folder does not have to be under InetPub, it can be anywhere on your local hard disk.

4. Create a SQL Database using SQL Server Management Studio or any tool that you are already using for managing databases, it can be named whatever you want, mojodb for example

5. Create a SQL user and add him as a dbo on the database you created in step 4 (your SQL Server or SQLExpress installation should be configured for mixed mode so you can use sql users)

6. In the root of the mojoportal folder rename the user.config.sample file to just user.config

7. Edit user.config with a text editor like Notepad and set your connection string there for the database, then close Notepad.

8. For testing purposes we will create a hosts file entry, right click Notepad and choose run as administrator

9. From the File menu choose open, then change the file type to all files instead of .txt

10.Browse to C:\Windows\System32\drivers\etc and open the hosts file (it has no file extension but it is a text file).

11. In the hosts file add a line as follows and save the file and close out of Notepad: mojoportal


12. Create a new Web Site in IIS and name it mojoportal, leave the IP address as "All Unassigned" but add the host name "mojoportal"

Point the web site root to the mojoportal folder and choose a .NET 4 Integrated application pool. 

13. Make note of the user that is the identity on the application pool. If the application pool is running as an internal identity, like "DefaultAppPool," in step 14 and 15 below you will use a user name of "iis apppool\your_apppool_name". E.g. iis apppool\DefaultAppPool.

14. In Windows Explorer, right click the mojoportal folder and choose properties, on the security tab click Edit..., then click Add..., then click Advanced..., then click Find Now

15. Select the user that is the identity on the application pool, then click OK, give the user read permissions here and click OK.

16. Repeat steps 14 and 15 on the /App_Data and /Data folders but this time, the user will already be there and you just need to change the permissions on these folders to Full Control for the user.

17. Open a web browser and navigate to http://mojoportal/

If all the above steps were done correctly it should automatically redirect to http://mojoportal/Setup/Default.aspx and that will complete the initial installation.


The above steps will get it working so you can see it when working directly on the server or Windows 7 machine. The hosts file entry only works on the current machine, to use it for an internet facing ip address you would need to setup DNS records to point to your ip address and then add the host name in IIS just as we added "mojoportal" in the above example.

Additional Resources

Last Updated 2011-04-20 by Joe Audette

Manual Installation in IIS 7.5 with MSSQL

This video walks through the manual steps to install mojoPortal in IIS 7.5 using MS SQL.

See other videos on the mojoPortal channel on YouTube.

Some of the same concepts covered in this video are also covered in the article Manual Installation Recipe for IIS 7.x and .NET 4.