Troubleshooting

​

Troubleshooting

Welcome to the Modus troubleshooting guide! This page covers common issues you might encounter, their resolutions, and best practices for triaging issues effectively.

​

Common issues and resolutions

​

Issue: CLI hangs during project initialization

Symptoms: the Modus CLI hangs indefinitely when running modus init.

Resolution:

1. Ensure you have the latest version of the Modus CLI installed.

2. Check your internet connection.

3. Run the command with the --verbose flag to get more detailed output:

   modus init --verbose
   If the issue persists, try deleting the .modus directory in your home folder and re-running the command.
   Issue: Environment Variables Not Loading
   Symptoms: Environment variables defined in .env are not being recognized by your Modus functions.