Skip to main content

How to Find ColdFusion or Lucee Application Error Logs

Developers can locate and access application error logs for ColdFusion or Lucee to diagnose runtime issues, identify stack traces, and troubleshoot application-specific failures.

Developers can locate and access application error logs for ColdFusion or Lucee to diagnose runtime issues, identify stack traces, and troubleshoot application-specific failures.

Before you begin

You will need:

  • Developer access to the server

  • Access to the specific application's directory or the server's configuration files

Locating Application Error Logs

Depending on your environment and how the application is configured, error logs can be found in several locations.

Checking the Default System Logs

By default, ColdFusion and Lucee log system-wide errors and some application errors to a central directory.

  1. Log in to the server.

  2. Navigate to the ColdFusion or Lucee installation directory.

  3. Locate the cfusion or lucee folder, typically C:\ColdFusion####\cfusion or C:\lucee.

  4. Open the logs folder.

  5. Look for files named exception.log, error.log, or messages.log.

Note: The exact filename may vary depending on the version of ColdFusion or Lucee you are running.

Checking Application-Specific Logs

If the application uses a custom logging framework (such as Log4j or a custom CFML logging class), the logs may be stored within the application's own directory.

  1. Navigate to the application's root directory.

  2. Look for a logs folder or a logs file within the application's directory.

  3. Check for files ending in .log or .txt that contain the application name.

Locating Logs via the Administrator Interface

If you have access to the ColdFusion Administrator or Lucee Administrator, you can verify the paths where the system is currently writing logs.

  1. Log in to the ColdFusion Administrator or Lucee Administrator.

  2. Navigate to System Settings > Logging.

  3. Review the paths listed for Error Log, Exception Log, and Message Log.

Confirm the result

  • You have located a log file that contains recent entries related to your application.

  • The log file contains a stack trace or a descriptive error message for the issue you are investigating.

Troubleshooting common log issues

The log file is empty or not updating

If the log files exist but do not contain new entries:

  • Verify that the ColdFusion or Lucee service is running.

  • Check that the user account running the service has "Write" permissions to the log directory.

  • Ensure the application is actually hitting the error; some errors may be caught by a custom error handler and not passed to the system log.

You cannot find any log files

If no logs are being generated:

  • Check the Logging section in the Administrator interface to ensure the paths are valid and the files are not being directed to a non-existent directory.

  • Verify that the disk space on the server is not full.

Did this answer your question?