Other common problems

Settings changes have no effect#

Cached configuration. Clear it:

php artisan optimize:clear

Anything edited in .env needs this. Changes made through Admin → Settings take effect immediately and do not.

The interface is in the wrong language#

Four things decide the language, in order: a signed-in user’s saved choice, a guest’s session choice, the browser’s Accept-Language header, then APP_LOCALE.

A signed-in user’s saved preference beats everything else — so if the panel keeps coming up in a language you did not expect, check that user’s profile before changing anything global.

Emails are not being sent#

Check MAIL_MAILER first. The shipped default is log, which writes messages to storage/logs/laravel.log instead of sending them. Then check that a queue worker is running, if your queue connection is database.

Emails send but land in spam#

Publish SPF and DKIM records for the domain in MAIL_FROM_ADDRESS, and send through a transactional provider rather than your host’s local mail server. Set-password links in a junk folder are indistinguishable, to the customer, from a broken product.

The license API returns 429#

Sixty requests per minute. Your integration is verifying too often — cache the result and check once or twice a day, not on every page load.

A customer has used up their domain slots on staging sites#

Deactivate the ones they no longer need; slots free immediately. To prevent it recurring, have your software skip the licensing call on local and staging hostnames.

Uploads fail on large release archives#

PHP limits, not the panel. Raise upload_max_filesize, post_max_size, and max_execution_time. If your host will not budge, put the archive on the disk directly and use the version sync endpoint instead.

Where to look first, always#

tail -n 100 storage/logs/laravel.log

Set APP_DEBUG=true only long enough to reproduce a problem, and turn it off immediately afterwards — it exposes stack traces and configuration to anyone who visits.