Installing ColdFusion 2018 with IIS on Windows 10 Pro

If you’re new to ColdFusion, the biggest challenge most individuals have is getting ColdFusion setup and running on their local machine. This tutorial will walk you through the process and get you to the point that you can begin your development journey.

When this tutorial is finished, you will have IIS running on your Windows machine and ColdFusion installed and configured to process your ColdFusion Development code.

First things first… let’s get IIS installed. (what is IIS? IIS is Microsoft Internet Information Services – Basically the Web Server that will serve your content over the web (or port 80).

Note: if you already have IIS, you can skip this step and go to Step 2. To see if you already have IIS installed, do this:

Step 1. Check and/or Install IIS on your local machine.

Click Start (the little windows icon on the lower left) > and type “IIS”. If you see the screen below and no application, then you do not.

Graphic 1.0 – Check for existence of IIS on the local machine.

If you see the screen above, then you do not have IIS, so we will need to get it installed. So let’s clear out the IIS text you entered and replace it with programs as you see below and click on the “Add or Remove Programs” option at the top of the list:

Graphic 1.1 – Access Add & Remove Programs

Next, let’s scroll all the way to the bottom of the screen in the window and click on the Programs and Features option as seen below:

Graphic 1.2 – Access Programs & Features.

That will low a new window, on the left side of the window you will see “Turn Windows features on or off”. Click that!

Graphic 1.3 – Turn on Windows Features on or off.

Now you are the area of Windows that allows you to install additional features into your machine… the option you are looking for is Internet Information Services (or IIS).

Graphic 1.4 – Install Internet Information Services (part 1)

If you expand that option you will see 3 sub-items under it.

Graphic 1.5 – Install Internet Information Services (part 2)

For the purposes of this tutorial you need to expand the Web Management Tools and World Wide Services and select all the options inside of them as follows:

Graphic 1.6 – Install Internet Information Services (part 3)

Then click on “OK” it will go through all the things it needs (if might prompt you to use Windows Update to download files needed, let it). When it’s all finished close all the windows and go back to the desktop. Then click start and type in IIS (like we did when we started this) and now you should see IIS as an application on the machine. (see below). That means it’s installed and ready to go (all it needs now is ColdFusion!)

Graphic 1.7 – Confirm IIS is now installed on your machine.

Step 2. Download ColdFusion 2018

Next you have to get a copy of ColdFusion. You have two options for this.
1. Download the Latest Version of ColdFusion from Adobe’s Website.
2. You can download ColdFusion (current or older version) from CFMLREPO
(as outlined in this tutorial)

For the purpose of this tutorial, we will be going to Adobe’s website (keep in mind that they change their site all the time, so it might change since this tutorial was created. Just go and download the latest version of ColdFusion). In your browser go to: https://www.adobe.com/products/coldfusion-family.html

On their site, click on “Free Trial” as outlined below, this will take you

Graphic 2.0 – Navigate to Adobe’s website and download ColdFusion Trial.

This will take you to a registration screen, fill out all the details necessary. There is an option that asks what version of ColdFusion you want to download. For the purposes of this tutorial we will select Windows 64 Bit English. (but you’re free to select a different option if one suits your needs better).

Graphic 2.1 – What version of ColdFusion would you like to download?

Then when you’re done at the bottom of the page click the download button. This will download the ColdFusion installation file. (keep in mind that the file is pretty large.. 900+MB so it might take a bit! Go get a coffee and a donut and come back!)…

Step 3. Install ColdFusion 2018

Double-Click on the ColdFusion installation file. This will prompt you to allow administrator access as seen below:

Graphic 3.0 – Launch the installer and grant administrator access

Click Yes, then let the installation software get situated:

Let the installer run to 100%…. that will load the ColdFusion installation wizard on the right.

Graphic 3.1 – Installation Begins

Accept the terms of the software and click Next.

Graphic 3.2 – Licensing Agreement

Next, comes the licensing screen… here for development you can select either the 30 day trial (this is a 30 day enterprise license) or you can select the developer edition. The difference between the two at a high level is the number of requests you can do to the local server from different visitor ip’s. Since you are installing on a local development machine the Developer edition would be just fine.

Graphic 3.3 – Serial Number / Installation Type

Next screen, let’s select Server Configuration and click Next.

Graphic 3.4 – Server Configuration

Next, let’s select a server profile. For development machine select “Development Profile” and click Next.

Graphic 3.5 – ColdFusion Server Profile

Next, select the sub-components.. When i am working on a local development environment I tend to leave them all on (as I don’t know what I’ll need later, but in production you’d only install what is absolutely necessary). For the purposes of this tutorial, leave all the options checked and click Next.

Graphic 3.6 – Sub-Components Installation

Next, screen will ask you for remote component credentials. the default username is “admin”. You can change it if you’d like or leave it as is… then enter and confirm your password. Then click next.

Graphic 3.7 – Remote Component Administrator Credentials

For the next screen, this defines if you would like to access services remotely… since this is a development environment leave it off and click Next.

Graphic 3.8 – Add-On Services Remotely

Next, the wizard wishes to know where to actually install ColdFusion on your machine. The default path is fine.

Graphic 3.9 – Installation Path

The next screen asks on what port do you want the built-in ColdFusion server to run on.. the default is 8500. You can leave this setting as is, unless you have something else running on that port already. Then click Next.

Graphic 3.10 – Built-In Web Server Port Number

The next screen is for performance monitoring tools… You can leave the value local to your development environment or put localhost or 127.0.0.1. Then click Next.

Graphic 3.11 – Performance Monitoring Toolset

The next screen will prompt you to enter in the ColdFusion administrator password. Make this something you will remember as you will use this area quite a bit in your development. This is the administration area where you connect databases, configure mappings, turn on debug and more… Type in and confirm your password and click Next.

Graphic 3.12 – Administrator Password

The next screen will prompt you for a password for RDS. This is ColdFusion’s Remote Development System. Basically ColdFusion gives you the ability to connect behind the scenes with your coding editor to get live database connections and server settings. I will be discussing this in a later tutorial, but for now enter in a password (same or different as before) and click Next.

Graphic 3.13 – RDS Configuration

After you’re done with that, next the installer will ask is if you’d like to turn on server updates. I usually leave it on and click Next.

Graphic 3.14 – Server Updates

That gets us to the final screen in the installer which will show you all the things you defined… double check them and click “Install”.

Graphic 3.15 – Installation Summary

Let the installer do it’s thing (another Donut?) Note that you might get prompted to allow Java access, if you do then click “Allow Access”

Graphic 3.16 – Windows Security Alert – Grant Access

When it’s done it will bring up a screen to tell you it’s done.

Graphic 3.17 – Completion Screen

Click on Done, it should open a browser window that will take you to the ColdFusion administrator. If it does not, open up your web browser and go to: http://127.0.0.1:8500/CFIDE/administrator/index.cfm

When the browser page loads, it will prompt you for a password that you entered in Graphic 3.12 above. Type the password in and click “login”.

Graphic 3.18 – ColdFusion Administration Migration Wizard Screen.

Let it do it’s thing for a bit… then you will see this screen:

Graphic 3.19 – and… we… are… finished…

Step 4. Configure ColdFusion to Talk to IIS

We have everything installed… next we need to configure the connectors so ColdFusion runs under IIS. To do this, click start and expand the Adobe folder. Then open the “Web Server Configuration Tool” as seen below.

Graphic 4.1 – ColdFusion – Web Server Configuration Tool

You will see a window like the one below; which basically states that nothing is configured yet. Click on the “add” button.

Graphic 4.2 – No Configured Web Servers

The following window outlines you are wanting to configure your localhost machine, using the IIS server. No need to change anything, just click “OK”.

Graphic 4.3 – Web Server Configuration for IIS

The configuration screen will prompt you that it will need to restart IIS. Click Yes.

Graphic 4.4 – Confirm you are ok with IIS being restarted.

When it’s done, you will see the same window as before, but this time it will show you that IIS is configured to run ColdFusion.

Graphic 4.5 – Confirmation that it worked and that IIS is configured to run ColdFusion.

Step 5. Testing that it works…

To test that everything worked, let’s create a simple ColdFusion template called “test.cfm” and save it to C:\inetpub\wwwroot\

<cfset isThisWorking = "Yes, It's Working!" />
<cfoutput>
    #isThisWorking#
</cfoutput>

Now in a browser, go to: http://127.0.0.1/test.cfm (if it all worked, you should see this)

Graphic 4.6 – It Worked, Woot!

And that concludes this tutorial… if you run into problems or need further help let us know.

Welcome to the exciting world of ColdFusion and soon you will be building some amazing things! We look forward to seeing them!

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s