Troubleshooting

This page collects common issues and their solutions.

General

MedUX does not start

• Check that all environment variables in .env are set correctly
• Verify the database is running and accessible
• Run medux check to see Django system check output
• Check the application logs for error messages

Static files not loading

• Run medux collectstatic
• Verify that STATIC_ROOT is set and served by your web server
• Clear your browser cache

Database migration errors

• During pre-alpha, migrations may conflict after updates. If this happens, back up your data, drop the database, recreate it, and run medux migrate followed by medux initialize

WebSocket / Notifications

Notifications not appearing in real time

• Verify that Redis is running and configured as the channel layer backend
• Check that Daphne (not a WSGI server) is serving the application
• Verify that your reverse proxy is configured to forward WebSocket connections

Plugins

Plugin not appearing after installation

• Run medux syncplugins to register the plugin
• Verify the plugin is listed in uv pip list
• Check that the plugin's entry point is correctly defined in its pyproject.toml
• Restart the application server