Skip to main content

Troubleshooting dotfiles for Codespaces

Troubleshooting steps for common dotfiles issues.

Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. 詳しい情報については「GitHubの製品」を参照してください。

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

  1. ドットファイルリポジトリがパブリックであることを確認します。 codespace で使用するシークレットまたは機密データがある場合は、プライベートドットファイルの代わりにCodespace シークレットを使用します。
  2. /workspaces/.codespaces/.persistedshare/dotfiles をチェックして、ドットファイルがクローンされたかどうかを確認します。
    • 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. 考えられる Issue については、/workspaces/.codespaces/.persistedshare/creation.log を確認します。 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.