close
The Wayback Machine - https://web.archive.org/web/20221110211216/https://docs.github.com/en/codespaces/troubleshooting/troubleshooting-dotfiles-for-codespaces
Skip to main content
 

 

Troubleshooting dotfiles for GitHub Codespaces

Troubleshooting steps for common dotfiles issues.

If your codespace fails to pick up configuration settings from dotfiles, you should work through the following debugging steps.

  1. Enable dotfiles by selecting Automatically install dotfiles in your personal GitHub Codespaces settings.

    The 'Automatically install dotfiles' option

  2. Check /workspaces/.codespaces/.persistedshare/dotfiles to see if your dotfiles were cloned.

    • If your dotfiles were cloned, try manually re-running your install script to verify that it is executable.
    • If your dotfiles were not cloned, check /workspaces/.codespaces/.persistedshare/EnvironmentLog.txt to see if there was a problem cloning them.

  3. Check /workspaces/.codespaces/.persistedshare/creation.log for possible issues. For more information, see Creation logs.

If the configuration from your dotfiles is correctly picked up, but part of the configuration is incompatible with codespaces, use the $CODESPACES environment variable to add conditional logic for codespace-specific configuration settings.