Troubleshooting

Common issues and solutions for GDSFactory+.

Installation Issues

Extension Not Loading

Symptoms: The GF+ icon doesn't appear in the sidebar, or the extension panel is empty.

Solutions:

  1. Restart VSCode after installing the extension
  2. Make sure you have opened a GDSFactory+ project folder (one with a pyproject.toml file)
  3. Check the VSCode Output panel (View > Output) and select "GDSFactory+" from the dropdown for error messages

API Key Not Working

Symptoms: "Invalid API key" or authentication errors.

Solutions:

  1. Verify your API key is correct at prod.gdsfactory.com under API Keys
  2. Check that the key is properly saved in your settings file:
    • macOS/Linux: ~/.gdsfactoryplus/gdsfactoryplus.toml
    • Windows: C:\Users\<YourUsername>\.gdsfactoryplus\gdsfactoryplus.toml
  3. Generate a new API key if the current one isn't working

UV Not Found

Symptoms: Error message about uv not being installed.

Solutions:

  1. Install uv by following the official installation guide
  2. Restart VSCode after installation
  3. Verify installation by running uv --version in the terminal

Platform-Specific Issues

Windows

Recommendation: For the best experience on Windows, install WSL (Windows Subsystem for Linux).

Common Windows issues:

  • Path issues: Use forward slashes (/) in paths or escape backslashes (\\)
  • Permission errors: Run VSCode as Administrator if you encounter permission issues
  • Long path errors: Enable long paths in Windows settings

macOS

  • Xcode required: Make sure Xcode is installed
  • Permission errors: Grant VSCode access to the folders you're working with in System Preferences > Security & Privacy

Linux

  • Display issues: Ensure your display environment is properly configured for GUI applications
  • Permission errors: Check file and folder permissions, or try running with elevated privileges

Network Issues

Firewall or Proxy Blocking Access

Symptoms: Timeouts, connection errors, or features not loading.

Solutions:

  1. Ensure your firewall allows connections to GDSFactory+ servers
  2. If behind a corporate proxy, configure VSCode to use your proxy settings
  3. Try temporarily disabling VPN if you're using one

Cloud Workspace Not Loading

Symptoms: Workspace link doesn't work or shows an error.

Solutions:

  1. Wait a minute for the workspace to fully initialize
  2. Check the Docker logs in the Customer Portal for error details
  3. Try creating a new workspace if the issue persists

Component Issues

Components Not Building

Symptoms: Components are greyed out or show build errors.

Solutions:

  1. Click the play button at the top of the Components menu to trigger a build
  2. Check the Output panel for error messages
  3. Verify your Python code has no syntax errors

DRC Not Running

Symptoms: DRC check doesn't complete or shows no results.

Solutions:

  1. Make sure you have the correct DRC rules configured in pyproject.toml
  2. Check that the component GDS file exists and is valid
  3. Review the timeout setting in your configuration

Getting More Help

If these solutions don't resolve your issue:

  1. Join the GDSFactory Community Slack for community support
  2. Check the Video Tutorials for step-by-step guidance
  3. Review the Local Installation or Cloud Setup guides to verify your setup
🤝 Community
On This Page