Skip to main content

Troubleshooting

.test domains don't resolve​

LaraEnv needs Administrator privileges to edit the hosts file at C:\Windows\System32\drivers\etc\hosts. If your .test domains don't resolve, relaunch LaraEnv as Administrator so it can patch the hosts file. See Paths & Ports.

Port already in use​

A service won't bind because another process holds the port. Open the Ports tool to find and kill the process. Common ports are 80, 443, 3306, 5432, 6379, 1025, and 8025.

504 errors or timeouts on long requests / big uploads​

Raise the relevant limits in Settings → Services (Service tuning):

  • fastcgi_read_timeout
  • client_max_body_size
  • PHP upload_max_filesize, post_max_size, and max_execution_time

SSL warning in the browser on .test​

Check the local CA's identity and trust status in Settings. LaraEnv signs local host certificates with its own CA; the installed edition attempts to trust it automatically, while portable copies require your explicit trust. A failed trust check or another certificate problem should be investigated before retrying. See Virtual hosts.

A project needs attention in Site Doctor​

Read the individual check and its guidance, then run the diagnosis again after resolving it. A stopped local MySQL service can cause a database warning even when no application page has recently queried the database. Optional storage-link suggestions do not reduce project health. Inconclusive checks are skipped rather than treated as confirmed failures. See Site Doctor.

A service won't start​

  • Check the service logs from the Dashboard.
  • Make sure the Visual C++ Redistributable is installed.
  • Make sure only one web server is using port 80/443.

Two web servers conflict​

Run Nginx or Apache, not both — they can't both own ports 80 and 443 at the same time.

Forgotten Cloud sync passphrase​

The sync passphrase is not recoverable. If you forget it, the encrypted data can't be decrypted and there is no way to recover it. See Cloud sync.

Migrating from Laragon, XAMPP, or Herd​

Point your projects into C:\laraenv\www\, pick the PHP version per project, and let LaraEnv generate the vhosts for you.