Skip to main content

Managing repository access for your organization's codespaces

You can manage the repositories in your organization that GitHub Codespaces can access.

Who can use this feature

To manage access and security for GitHub Codespaces for an organization, you must be an organization owner.

GitHub Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. GitHub Codespaces is also available as a limited beta release for individual users on GitHub Free and GitHub Pro plans. For more information, see "GitHub's products."

Deprecation note: The access and security setting described below is now deprecated and is documented here for reference only. To enable expanded access to other repositories, add the requested permissions to your devcontainer.json configuration file. For more information, see "Managing access to other repositories within your codespace."

By default, a codespace can only access the repository where it was created. When you enable access and security for a repository owned by your organization, any codespaces that are created for that repository will also have read permissions to all other repositories the organization owns and the codespace creator has permissions to access. If you want to restrict the repositories a codespace can access, you can limit it to either the repository where the codespace was created, or to specific repositories. You should only enable access and security for repositories you trust.

To manage which users in your organization can use GitHub Codespaces, see "Enabling GitHub Codespaces for your organization."

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations. Your organizations in the profile menu
  2. Next to the organization, click Settings. The settings button
  3. In the left sidebar, click Codespaces.
  4. Under "Access and security", select the setting you want for your organization. Radio buttons to manage trusted repositories
  5. If you chose "Selected repositories", select the drop-down menu, then click a repository to allow the repository's codespaces to access other repositories owned by your organization. Repeat for all repositories whose codespaces you want to access other repositories. "Selected repositories" drop-down menu

Further reading