Skip to content

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:

Terminal window
# 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:
    • Steps to reproduce
    • Expected behavior
    • Actual behavior
    • VS Code version
    • Zephyr IDE version
    • Operating system

Next Steps