Help & FAQ
Troubleshooting
# 54
Last editetd on 15 June 2026
Solutions for common problems during installation and operation of JoomBook.
Installation Errors
"Error installing the package"
- Check that PHP 8.3 or higher is installed
- Check that the
/tmp directory is writable
- Temporarily increase
upload_max_filesize and post_max_size in php.ini to at least 32 MB
Plugins not activated after installation
Navigate to System → Plugins, search for "joombook" and manually enable all plugins found.
Frontend Issues
Booking wizard does not appear
- Check that
mod_joombook_wizard is enabled and assigned to the correct page
- Check under System → Plugins that the "JoomBook AJAX Handler" plugin is enabled
- Open the browser console (F12) for error messages
JavaScript errors in the console
Make sure no other plugin or template is loading Alpine.js in an incompatible version. JoomBook includes its own copy of Alpine.js.
Backend Issues
No appointments visible in the calendar
Check that FullCalendar is loaded correctly: look for fullcalendar files in the Network tab of browser developer tools. If not loaded: clear the cache and reload.
License key is not accepted
- Make sure your server allows outgoing HTTPS connections to
license.joombook.com
- Check that the PHP extension
curl is enabled
- Try again after 60 seconds (rate limiting)