Troubleshooting

If mod_wsgi is not behaving as expected, start with the relevant “issues” guide based on where the problem is:

• Installation Issues — building and loading the mod_wsgi module.

• Configuration Issues — Apache configuration for mod_wsgi.

• Application Issues — running the WSGI application once mod_wsgi is loaded.

If you have a specific WSGI#### error code in the Apache error log, look it up in Error Reference for the cause and any recommended action.

Additional pages that may help:

• Checking Your Installation — sanity checks for an Apache plus mod_wsgi setup.

• Debugging Techniques — running Apache in the foreground, inspecting daemon processes, and other diagnostic approaches.

• Frequently Asked Questions — common questions and gotchas.

If none of these resolve the issue, see Finding Help for where to ask.