1. Overview

If any problems arise or if you are unable to access FusionAuth, consult the FusionAuth log files. In most cases API errors will be written out to the fusionauth-app.log file.

If you need further assistance, please ask a question on Stack Overflow or open an issue on Github if you have additional questions. If you have a licensed edition you may send a request to

1.1. Logs

The following are the default locations for each of the FusionAuth log files. You may or may not have all of the FusionAuth services installed on the same system so you may not have all of the following logs on your server.

Linux and macOS

These paths assume the suggested product location of \fusionauth. This path may be different on your system depending on where you unpacked the zip files.


1.2. Event Log

Available since 1.6.0

The event log is a FusionAuth message store designed to capture different types of events that may be necessary to communicate to a FusionAuth developer or admin user.

The event log may contain helpful details to indicate the cause of the failure, or a failure condition you need to be aware of in FusionAuth. See System Event Log.

While not limited to, generally speaking the event log will contain events or errors related to external systems or asynchronous issues that are difficult to communicate to the API caller or the FusionAuth admin at runtime. While not intended to be an exhaustive list, examples of these types of errors are:

  • SMTP connection issues

  • Lambda invocation errors

  • External identity provider failures or configuration issues

  • Failure to deliver a webhook event

2. Common Errors

Be sure to review the Common Errors page to see if there are any fixes for any issues you encounter.