Understanding what Automad is doing internally can be helpful during theme and extension development or when troubleshooting an installation. Debug logging can be enabled temporarily through System Setting → Debug.
When enabled, Automad logs internal processes to a file. The file path for your installation can be retrieved using the Automad Console by running the following command from your installation's root directory:
php automad/console log:pathOn Linux or macOS, you can monitor the log file in real time using:
tail -n +1 -F $(php automad/console log:path)This command can be combined with standard utilities like grep to filter log output for more targeted troubleshooting.
Browser Console
Log output can be forwarded to the browser console, which is useful when you want to monitor internals from within the browser during development. Keep in mind that console log forwarding may impact site performance.
During Development
When developing extensions, you can use Automad's internal Debug class to log output:
<?php
use Automad\Core\Debug;
Debug::log($element, $description);