Troubleshooting Modules
Encountering issues with module installation or configuration? Here are some common problems and solutions:
Common Issues
Module Not Installing
If you're having trouble installing a module, ensure that you have the correct module package and that it is compatible with your version of Oqtane. Also, check for any errors in the installation process.
Module Not Functioning Properly
If a module is not working as expected, verify that it is configured correctly and that any required dependencies are installed. Check the Oqtane logs for error messages or warnings that may indicate the cause of the issue.
Error Messages
If you encounter error messages during module installation or configuration, note down the error message and any accompanying details. Search for solutions online or consult the Oqtane community forums for assistance.
Troubleshooting Steps
- Check Compatibility: Ensure that the module is compatible with your version of Oqtane and any other installed modules or themes.
- Review Configuration: Double-check the module configuration settings to ensure that everything is configured correctly.
- Inspect Logs: Look for error messages or warnings in the Oqtane log files, located in the /Logs directory of your Oqtane installation.
- Update Dependencies: Make sure that all dependencies required by the module are up-to-date and installed correctly.
- Contact Support: If you're unable to resolve the issue on your own, reach out to the module developer or the Oqtane community for assistance.
By following these troubleshooting steps, you should be able to diagnose and resolve most module-related issues on your Oqtane site.