Skip to main content

Troubleshooting

Could not find the .env file anywhere
In many operating systems, the .env file is hidden by default to prevent accidental modifications by users. If you cannot locate the .env file in the application directory, you may need to enable the "Show hidden files" option in your file explorer. Follow these steps to reveal hidden files:

Windows File Explorer:
  1. Open File Explorer.
  2. Click on the "View" tab in the top menu.
  3. Look for the "Hidden items" checkbox in the "Show/Hide" group. Check this box to display hidden files and folders.
macOS Finder:
  1. Open Finder.
  2. Navigate to the directory where the .env file is located.
  3. Press "Command + Shift + Period" (⌘ + ⇧ + .) to reveal hidden files. This keyboard shortcut will toggle the visibility of hidden files.
Linux (Ubuntu, Debian, etc.):
  1. Open the File Manager.
  2. Press "Ctrl + H" to toggle the display of hidden files and folders.
  3. Once you have enabled the "Show hidden files" option, you should be able to find and access the .env file in the application directory.
Error after editing the .env file
If you encounter an error after editing the .env file, it is likely that you have made a mistake in the file. The most common mistakes are:

  1. Adding a space between the variable name
    • Mistake: APP_NAME=My App
    • Correct: APP_NAME="My App"
  2. Adding a space between the variable name and the value
    • Mistake: APP_NAME = "My App"
    • Correct: APP_NAME="My App"
  3. Uneven or unbalanced quotation marks in values, such as forgetting to close a pair of quotes
    • Mistake: APP_NAME="MyApp
    • Correct: APP_NAME="My App"