Known Issues

Dev containers with WSL and Windows folders

When using dev containers in a WSL environment, ensure your workspace folder is located within the Ubuntu file system (e.g., /home/username/project) rather than in mounted Windows directories (e.g., /mnt/c/Users/...).

This is an issue inherent with the west boards command and affects workspace initialization and board detection.

Workaround

Move your project to a location within the WSL file system:

# Instead of /mnt/c/Users/yourname/projects
# Use /home/yourname/projects

Reporting Issues

If you encounter other issues:

1. Check the GitHub Issues to see if it's already reported
2. Create a new issue with:
3. Steps to reproduce
4. Expected behavior
5. Actual behavior
6. VS Code version
7. Zephyr IDE version
8. Operating system

Next Steps

• Report an issue on GitHub
• Join discussions