Skip to content
This repository has been archived by the owner on May 14, 2022. It is now read-only.
/ lucee5-heroku Public archive

Blank application template to deploy Lucee 5 apps on Heroku

License

Notifications You must be signed in to change notification settings

mikesprague/lucee5-heroku

Repository files navigation

Lucee 5 Application Template for Heroku

NO LONGER MAINTAINED

After the recent Heroku breach (and more than the breach, it was the way comms were handled) I closed my 10+ year old Heroku account. As such, there are no more live demos. I haven't been using Lucee/CFML for several years at this point either so this repo will no longer be maintained.


Credits/Notes

  • This project is based off of the offical Lucee Heroku Buildpack

Requirements

Instructions

To get started, run the following commands in GitBash (or your terminal of preference):

git clone https://github.com/mikesprague/lucee5-heroku.git
cd lucee5-heroku
mvn package
foreman start

NOTE: On Windows, start foreman with the following command:

foreman start -f Procfile.dev

You should now have Lucee up and running at http://localhost:5000. Start adding your code.

To deploy your site to Heroku you need to setup a free Heroku account, install the Heroku toolbelt (Suggested reading: Getting Started with Java on Heroku). Then...

heroku apps:create [NAME]
git push heroku master
heroku open

You should now be looking at your app running on Heroku.

NOTES:

  • If you need access to the admin, disable the first rule in urlrewrite.xml.
  • Default password for web admins is password. This should be changed to something secure before deploying your app.
  • Make any settings (datasources, mail settings, etc.) changes you want locally via the web context, commit your changes and then deploy your app and they will also exist on Heroku.
    • Better practice to add any settings changes, datasources, etc. via Application.cfc; use web context for changes if you must set them via Lucee Admin
    • Server context will be overwritten on deploy, very important desired changes are made to web context if you wish to keep them
  • If you get a Heroku application error try reloading the page. This is a known issue. I think the Lucee dependencies aren't quite ready when this happens, I need to look into it further.

Enjoy!

Known Projects Using the Lucee 5 Application Template for Heroku

Have a project making use of this application template? Lem me know and I'll be happy to list it below!