# IIS Setup for ProteanCMS

Follow these steps to create your site in IIS and configure common mappings.

---

## Step 1: Create IIS Site

Create your site in IIS at the following location:

**Path:**  
`yourdrive:\HostingSpaces\ClientSites\ClientName-gitrepo-\wwwroot`

![Adding a Website in IIS](/.attachments/1_add_web_site-57ffd0f2-6c0b-4681-9095-62d0ba040ec5.gif)

---

## Step 2: Set Up Common Mappings

To simplify setup, we recommend using the following mappings.

1. **Run the following command in the Command Line (Admin Mode):**  
   _(Only required once per machine)_

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

2. **Map the `ewcommon` Directory in IIS:**
   - Open **IIS Manager** for your site.
   - Click on **View Applications**.
   - Select **Add Application**.
   - Set the **Alias** to: `ewcommon`.
   - Set the **Physical Path** to: `yourdrive:\HostingSpaces\ewcommon`.
   - Click **OK**.

---

## Step 3: Update Hosts File

Edit the `hosts` file (`C:\Windows\system32\drivers\etc\hosts`) using Notepad or another text editor, and add the following line to create a local name:

```
127.0.0.1 clientsite.co.uk  
```

---

## Step 4: Set Up SQL Database

1. In **SQL Server 2008**, create a **database username** and **password** using SQL authentication.

2. **Run the ProteanCMS Setup:**
   - Open your browser and go to:  
     `http://clientsite.co.uk/ewcommon/setup`.
   - Fill in any fields that aren't auto-populated and click **Continue** to set up the database and copy files. This may take a few moments.

3. **Set Database Permissions:**
   - Open the properties for the SQL login you just created.
   - Select **User Mapping**.
   - Tick the box next to the newly created database.
   - Tick the box next to the **db_owner** role.

---

## Step 5: Finalize Setup

1. On the next page of the **eonicweb 5** setup, click **Continue** to populate the database.

2. **Copy the `ewThemes` Directory:**  
   Copy (do not map) the `ewThemes` directory to the `wwwroot` directory. You may need to fix references (this might be done automatically during setup).

3. **Log into eonicweb:**  
   - Username: `admin`  
   - Password: `buster`

   If the login is successful, the installation has completed.

---

- [Back to ProteanCMS Version 5](/Front-End-Developer-Guide/v5)

---