common issues, resolutions, and best practices
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:
-
Ensure you have the latest version of the Modus CLI installed.
-
Check your internet connection.
-
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.
