You can personalize GitHub Codespaces by using a
dotfiles repository on GitHub or by using Settings Sync. For more information, see "Personalizing GitHub Codespaces for your account."
If your codespace fails to pick up configuration settings from dotfiles, you should work through the following debugging steps.
Enable dotfiles by selecting Automatically install dotfiles in your personal GitHub Codespaces settings.
/workspaces/.codespaces/.persistedshare/dotfilesto 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.txtto see if there was a problem cloning them.
/workspaces/.codespaces/.persistedshare/creation.logfor 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. For more information about configuration that may be incompatible with codespaces, see:
- "Troubleshooting authentication to a repository"
- "Troubleshooting GPG verification for GitHub Codespaces"
You can turn off Settings Sync to stop syncing settings to and from an instance of VS Code.
When you turn off Settings Sync in a codespace, new codespaces continue to use the settings cached from the last time your settings were pushed to the cloud. If you use the VS Code web client for codespaces, and want codespaces to use the default settings instead of your cached settings, you can disable Settings Sync. For more information, see "Managing your preferences for Settings Sync."
If you want to return to using the default VS Code settings in all instances of VS Code, including the desktop application, you can clear the cache in the cloud when you turn off Settings Sync.
If Settings Sync is currently turned off in your instance of VS Code, and you want to clear your cached settings, you must first turn it on. For instructions, see "Personalizing GitHub Codespaces for your account."
At the bottom of the Activity Bar, select and click Settings Sync is On.
In the dropdown, click Settings Sync: Turn Off.
To clear your cached settings, in the dialog, select Turn off sync on all your devices and clear the data from the cloud.
Click Turn off.