Setup an existing website for local development - Eonic/ProteanCMS GitHub Wiki

Setting Up IIS for a ProteanCMS Website

Follow these steps to create and configure your site in IIS:

1. Create the Site in IIS

Navigate to the following location on your drive to set up the site:

yourdrive:\HostingSpaces\ClientSites\ClientName-gitrepo-\wwwroot

  • Clone the website from GIT: If there’s no Git repository, create a new one and copy the wwwroot folder from the live webserver.

  • Ensure you have ProteanCMS installed: The CMS should be located in HostingSpaces/ProteanCMS.

2. Set Up the ewcommon Directory

Before proceeding, you’ll need to run the following command once per machine (in Command Prompt, in Admin mode):

mklink /d D:\HostingSpaces\ewcommon_v5-1 D:\HostingSpaces\ProteanCMS\wwwroot\ewcommon

This command creates a symbolic link for the ewcommon directory.

3. Map ewcommon in IIS

  1. Open IIS Manager for your site.
  2. Under View Applications, click Add Application.
  3. Set the following:
    • Alias: ewcommon
    • Physical Path: yourdrive:\HostingSpaces\ewcommon
  4. Click OK.

If you are working with ProteanCMS 6, replace ewcommon with ptn.

4. Edit the Hosts File

To access your site locally, you need to map a local domain name. Edit the hosts file, located at C:\Windows\system32\drivers\etc\hosts, using Notepad (in Admin mode) or a similar editor.

Add the following line:

127.0.0.1 clientsite.co.uk

Alternatively, you can use software like Host File Editor to manage the hosts file easily.

5. Open and Debug in Visual Studio

Once the setup is complete, open the website solution in Visual Studio (run it in Admin mode) and you should be able to debug the site.

⚠️ **GitHub.com Fallback** ⚠️