Cfwheels

Installing CFWheels on ColdFusion / Railo

1. Download the latest version from http://cfwheels.org/download
2. Unzip the contents to a folder on your computer
3. Remove the "web.config" and "IsapiRewrite4.ini" files.
4. Edit the .htaccess with any plain text editor (I.E. notepad, wordpad, etc.) and replace the contents with the following:

   RewriteEngine On
    
   RewriteCond %{REQUEST_URI} !^.*/(flex2gateway|jrunscripts|cfide|cfformgateway|CFFileServlet|railo-context|files|images|javascripts|miscellaneous|stylesheets|robots.txt|sitemap.xml|rewrite.cfm)($|/.*$) [NC]
   RewriteRule ^(.*)$ /rewrite.cfm/$1 [L]

5. Setup a MySQL database and create a ColdFusion / Railo DSN for the database. Below are some tutorials on how to do this through your control panel:
   • How to create a MySQL Database
   • How to create a ColdFusion DSN
   • How to create a Railo DSN
6. Edit the config/settings.cfm file in a plain text editor and enter your datasource name and your database username and password. Also, remove the comments around that section:
   Example:

   <cfset set(dataSourceName="MyDSNName")>
   <cfset set(dataSourceUserName="MyDatabaseUsername")>
   <cfset set(dataSourcePassword="MyDatabasePassword")>

7. Upload the files to your site. They must be inside the /wwwroot (Windows) or /public_html (cPanel/Linux) folder for URL rewriting to work properly.

Browse to your site, and you should see the default CFWheels home page.