Installing ColdFusion is straightforward and usually takes just a few minutes. In this lesson, we'll install Adobe ColdFusion 2025 using the Server Configuration, which is the recommended option for beginners and local development.
Recommendation: throughout this course, we'll use the Developer Edition of Adobe ColdFusion, which is intended for learning and development. Always review Adobe's latest licensing terms for the version you're installing.
Before You Begin
- Windows, macOS, or Linux
- Administrator (or sudo) privileges
- An internet connection, for downloading the installer
- Sufficient free disk space
- A supported Java Runtime, if your installation method requires one
Step 1 — Download Adobe ColdFusion
Download the installer that matches your operating system from Adobe's official website.
| Operating System | Example Installer |
|---|---|
| Windows | coldfusion_2025_WWEJ_win64.exe |
| macOS | coldfusion_2025_WWEJ.dmg |
| Linux | ColdFusion_2025_WWEJ_linux64.bin |
Tip: always download the installer from Adobe's official website rather than a third-party mirror.
Step 2 — Run the Installer
Launch the installer and follow the setup wizard. Early on, it asks you to choose an installation type.
- Includes an embedded Apache Tomcat server
- Easiest to install
- Requires minimal configuration
- Ideal for learning and development
- Choose this only if you're deploying into an existing Java application server, such as WebLogic, JBoss, or WebSphere
Step 3 — Choose a License
During installation, Adobe will ask you to select a licensing option. If you're learning ColdFusion, you can install the evaluation version and use the Developer Edition for local development according to Adobe's licensing terms.
For the latest licensing information, refer to Adobe's official documentation — this is exactly the kind of detail that can change between releases.
Step 4 — Choose Deployment Type
Select Development. This profile turns on the settings that make development and debugging easier — it isn't meant for handling real visitor traffic.
Step 5 — Optional Components
You may see optional components such as:
- PDF Services
- Solr Search
For your first installation, these can be left unchecked. You can always install or configure additional services later when you actually need them.
Step 6 — Choose Installation Directory
The default installation directory is usually sufficient.
| Operating System | Default Directory |
|---|---|
| Windows | C:\ColdFusion2025 |
| Linux | /opt/ColdFusion2025 |
| macOS | /Applications/ColdFusion2025 |
Step 7 — Configure the Web Server Port
By default, ColdFusion uses port 8500. Unless another application is already using this port, keep the default value.
Step 8 — Set the Administrator Password
During installation, you'll be asked to create a password for the ColdFusion Administrator — a web-based dashboard used to:
- Configure datasources
- Manage server settings
- Configure mappings
- Manage scheduled tasks
- Monitor logs
- Configure security
Choose a strong password and keep it somewhere safe — you'll use this dashboard throughout the course.
Step 9 — Complete the Installation
Click Install and wait for the setup process to finish. Once installation is complete, the installer may offer to launch the ColdFusion Administrator automatically.
Verify the Installation
Open your browser and visit:
http://localhost:8500/CFIDE/administrator
If the Administrator login page appears, your installation was successful.
ColdFusion Directory Structure
After installation, you'll see a folder structure similar to this:
ColdFusion2025/ │ ├── cfusion/ │ ├── wwwroot/ │ ├── lib/ │ ├── logs/ │ ├── runtime/ │ └── bin/ │ └── jre/
The Important Folder: wwwroot
cfusion/wwwroot/ is your web root. Every .cfm file you create during this course will be stored here.
wwwroot/ ├── hello.cfm ├── index.cfm └── exercises/
Linux Installation
On Linux, installation happens from the terminal rather than a graphical wizard:
Using CommandBox (Optional)
If you prefer working from the command line, CommandBox by Ortus Solutions can download and run Adobe ColdFusion without using the graphical installer at all. For example:
CommandBox is an excellent choice for developers who frequently create and remove local development environments.
Common Problems
Port 8500 already in use
Change the port during installation, or stop whatever application is already using that port.
Administrator doesn't open
Verify that the ColdFusion service is running, and restart it if necessary.
404 error
Make sure your .cfm files are inside the wwwroot directory.
What's Next?
Now that ColdFusion is installed, you're ready to create your first application. In the next lesson, we'll build a simple Hello World program and see exactly how ColdFusion processes a web request.