Whatever message this page gives is out now! Go check it out!

ColdFusion Apache manual connector configuration

Last update:
May 18, 2026
This document applies to:
  • ColdFusion (2023 release)
  • ColdFusion (2021 release)
  • ColdFusion (2018 release)
  • ColdFusion (2016 release)
  • ColdFusion 11
  • ColdFusion 10
Adobe ColdFusion comes with a webserver configuration tool for connecting to external web servers. There can be occasions, however, when the tool doesn't work properly. If the tool doesn't work, you can configure the connector manually. This TechNote demonstrates the steps required to manually configure a connection to Apache.
Adobe ColdFusion connects to webserver through Connector Port, which is in server.xml. You can find this file in the {CF-HOME}\cfusion\runtime\conf directory.
In all the configuration below, replace {CF-HOME} with actual ColdFusion10 installation directory. (For example, the installation directory on UNIX is /opt/ColdFusion10 and C:\ColdFusion10 for windows.).
  1. Extract the .so file from wsconfig.jar, in {CF-HOME}\cfusion\runtime\lib.
    • For Apache 64 bit, .so is under connectors\apache\intel-win64\prebuilt\mod_jk22.so
    • For Apache 32 bit, .so is under connectors\apache\intel-win\prebuilt\mod_jk22.so
  2. Create a folder under {CF-HOME}\config\wsconfig\{magic-number}, and copy the connector in that folder.
  3. Create a file uriworkermap.properties and copy the content below into it.
    /cfformgateway/* = cfusion

    /CFFormGateway/* = cfusion

    /flex2gateway/* = cfusion

    /flex2gateway = cfusion

    /cffileservlet/* = cfusion

    /CFFileServlet/* = cfusion

    /cfform-internal/* = cfusion

    /flashservices/gateway/* = cfusion

    /flex-internal/* = cfusion

    /rest/* = cfusion

    /*.cfml/* = cfusion

    /*.mxml = cfusion

    /*.as = cfusion

    /*.cfm = cfusion

    /*.cfm/* = cfusion

    /*.swc = cfusion

    /*.cfml = cfusion

    /*.cfc = cfusion

    /*.cfc/* = cfusion

    /*.cfr = cfusion

    /*.cfswf = cfusion

    /*.sws = cfusion

    /*.jsp = cfusion

    /*.hbmxml = cfusion
  4. Create workers.properties under {CF-HOME}\config\wsconfig\{magic-number} and copy the content below into it. Make sure that the port mentioned is same as connector port mentioned for protocol "AJP/1.3" in server.xml.
    worker.list=cfusion

    worker.cfusion.type=ajp13

    worker.cfusion.host=localhost

    worker.cfusion.port=8012

    worker.cfusion.max_reuse_connections=250
  5. Create mod_jk.conf file in Apache configuration directory. Add the extracted connector path in the content below.
    LoadModule jk_module "{CF-HOME}\config\wsconfig\{magic_no}\mod_jk.so"

    # Where to find workers.properties

    JkWorkersFile "{CF-HOME}\config\wsconfig\{magic_no}\workers.properties"

    JkMountFile "{CF-HOME}\config\wsconfig\{magic_no}\uriworkermap.properties"

    # Where to put jk logs

    JkLogFile "{CF-HOME}\config\wsconfig\{magic_no}\mod_jk.log"

    # Where to put jk shared memory

    JkShmFile "{CF-HOME}\config\wsconfig\{magic_no}\jk_shm"

    # Set the jk log level [debug/error/info]

    JkLogLevel info

    # Select the timestamp log format

    JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "

    AddHandler jakarta-servlet .cfm .cfml .cfc .cfr .cfswf
    Options Indexes FollowSymLinks

    AllowOverride None

    Order allow, deny

    Allow from all
    Order allow, deny

    Deny from all
  6. Open the httpd.conf from the Apache config directory. Add the line below at the end of the httpd.conf file.
    Include "C:\Program Files (x86)\Apache Software Foundation\Apache2.2\conf\mod_jk.conf"
  7. Restart Apache.
Note:
You can also download Connector binaries here.

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page