👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Personalizing Codespaces for your account

Espaços de código uses your dotfiles repository on GitHub to personalize every new codespace that you create.

Anyone can create a dotfiles repository to personalize Espaços de código for their user account.

Os espaços de códigos estão disponíveis para contas de usuário usando GitHub Free ou GitHub Pro. Para obter mais informações, consulte os "produtos do GitHub".

Você conseguiu encontrar o que estava procurando?

Note: Espaços de código is currently in limited public beta and subject to change. During the beta period, GitHub does not make any guarantees about the availability of Espaços de código. For more information about joining the beta, see "About Espaços de código."

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.

Your 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 Espaços de código 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.

  • install.sh
  • install
  • bootstrap.sh
  • bootstrap
  • setup.sh
  • setup

If none of these files are found, then any files or folders in dotfiles starting with . are symlinked to the codespace's ~ or $HOME directory.

Any changes to your dotfiles repository will apply only to each new codespace, and do not affect any existing codespace.

For more information, see Personalizing in the Visual Studio Code documentation.

Note: Currently, Espaços de código 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 Espaços de código for your project."

Further reading

Você conseguiu encontrar o que estava procurando?

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato