Troubleshooting

Homer blocks deletions I need to make

If you’re in block mode and need to delete an element, you have a few options:

• If you’re an admin and adminBypass is enabled (the default), you can bypass all checks.
• Ask a user with the homer:bypassBlocks permission to perform the deletion.
• Temporarily switch to confirm or warn mode in your config file.

Impact analysis shows zero references but I know there are some

Homer queries Craft’s relations table. If references exist in plain text or rich text fields but not through relation fields, they won’t appear in the standard usage graph. Enable assetSafety for asset-specific scanning that also checks rich text content via Craft’s search index.

Audit log is growing too large

Adjust the auditLogRetentionDays setting to a shorter period. The default is 90 days. Homer automatically cleans up entries older than the configured retention period.

Strict environments not working

Make sure your CRAFT_ENVIRONMENT environment variable matches one of the values in the strictEnvironments array. The comparison is case-sensitive.

Getting Help

If you encounter issues, please open an issue on GitHub.