Note: Codespaces is currently in limited public beta and subject to change. During the beta period, GitHub does not make any guarantees about the availability of Codespaces. For more information about joining the beta, see "About Codespaces."
Dotfiles are files and folders on Unix-like systems starting with
. that control the configuration of applications and shells on your system. You can store and manage your dotfiles in a repository on GitHub. For advice and tutorials about what to include in your
dotfiles repository, see GitHub does dotfiles.
If your user account on GitHub owns a public repository named
dotfiles, GitHub automatically uses this repository to personalize your codespace environment. Private
dotfiles repositories are not currently supported.
dotfiles repository might include your shell aliases and preferences, any tools you want to install, or any other codespace personalization you want to make.
Codespace personalization using your
dotfiles repository applies to any codespace you create. Project maintainers can also define a default configuration that applies to every codespace for a repository, created by anyone. Your
dotfiles personalization is applied before a repository's default codespace configuration. For more information, see "Configuring Codespaces for your project."
When you create a new codespace, GitHub clones your
dotfiles repository to the codespace environment, and looks for one of the following files to set up the environment.
If none of these files are found, then any files or folders in
dotfiles starting with
. are symlinked to the codespace's
Any changes to your
dotfiles repository will apply only to each new codespace, and do not affect any existing codespace.
Note: Currently, Codespaces does not support personalizing the User settings for the Visual Studio Code editor with your
dotfiles repository. You can set default Workspace and Remote [Codespaces] settings for a specific project in the project's repository. For more information, see "Configuring Codespaces for your project."
You can also configure settings for your user account to add encrypted secrets, enable GPG verification, and allow your codespaces to access other repositories. For more information, see "Managing encrypted secrets for Codespaces", "Managing GPG verification for Codespaces", and "Managing access and security for Codespaces."