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​

The local certificate is self-signed, so this warning is expected. Proceed past it, or trust the certificate to silence it.

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.