{"meta":{"title":"Managing prebuilds","intro":"You can review, modify, and delete the prebuild configurations for your repository.","product":"Codespaces","breadcrumbs":[{"href":"/en/codespaces","title":"Codespaces"},{"href":"/en/codespaces/prebuilding-your-codespaces","title":"Prebuilding your codespaces"},{"href":"/en/codespaces/prebuilding-your-codespaces/managing-prebuilds","title":"Manage prebuilds"}],"documentType":"article"},"body":"# Managing prebuilds\n\nYou can review, modify, and delete the prebuild configurations for your repository.\n\n## About managing prebuilds\n\nThe prebuilds that you configure for a repository are created and updated using a GitHub Actions workflow, managed by the GitHub Codespaces service.\n\nDepending on the settings in a prebuild configuration, the workflow to update the prebuild may be triggered by these events:\n\n* Creating or updating the prebuild configuration\n* Pushing a commit or a pull request to a branch that's configured to have prebuilds\n* Changing any of the dev container configuration files\n* A schedule that you've defined in the prebuild configuration\n* Manually triggering the workflow\n\nThe settings in the prebuild configuration determine which events automatically trigger an update of the prebuild. See [Configuring prebuilds](/en/codespaces/prebuilding-your-codespaces/configuring-prebuilds#configuring-prebuilds).\n\nPeople with admin access to a repository can check the progress of prebuilds, edit, and delete prebuild configurations.\n\nTo locate all repositories that are hosting a prebuild configuration, you must obtain a copy of your usage report by following the steps for [Viewing your usage of metered products and licenses](/en/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage).\n\n## Viewing the progress of prebuilds\n\nYou can view the current status of the latest workflow run for each prebuild configuration you've set up on the GitHub Codespaces page of your repository settings. For example, \"Currently running\" or \"Last run 1 hour ago.\"\n\nTo see the log output for the latest prebuild workflow run, click **See output**.\n\n\n\nThis displays the output of the most recent run of the workflow in the **Actions** tab.\n\n\n\nAlternatively, to view all prebuild workflow runs associated with the specified branch, select the dropdown menu and click **View runs**.\n\n\n\nThis displays the workflow run history for prebuilds for the associated branch.\n\n\n\n## Editing a prebuild configuration\n\n1. On the Codespaces page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to edit.\n\n2. In the dropdown menu, click **Edit**.\n\n \n\n3. Make the required changes to the prebuild configuration, then click **Update**.\n\n If the dev container configuration for the repository specifies permissions for accessing other repositories, you will be shown an authorization page. For more information on how this is specified in the `devcontainer.json` file, see [Managing access to other repositories within your codespace](/en/codespaces/managing-your-codespaces/managing-repository-access-for-your-codespaces).\n\n Click to view the details of the requested permissions.\n\n \n\n Click **Authorize and continue** to grant these permissions for creation of prebuilds. Alternatively, you can click **Continue without authorizing** but, if you do so, codespaces created from the resulting prebuilds may not work properly.\n\n > \\[!NOTE]\n > Users who create codespaces using this prebuild will also be asked to grant these permissions.\n\n## Disabling a prebuild configuration\n\nTo pause the update of prebuilds for a configuration, you can disable workflow runs for the configuration. Disabling the workflow runs for a prebuild configuration does not delete any previously created prebuilds for that configuration and, as a result, codespaces will continue to be generated from an existing prebuild.\n\nDisabling the workflow runs for a prebuild configuration is useful if you need to investigate prebuild creation failures.\n\n1. On the Codespaces page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to disable.\n\n2. In the dropdown menu, click **Disable runs**.\n\n \n\n3. To confirm that you want to disable this configuration, click **OK**.\n\n## Deleting a prebuild configuration\n\n> \\[!NOTE]\n> You can find a list of the repositories that contain a prebuild by obtaining a copy of your “[usage report](/en/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage).”\n\nDeleting a prebuild configuration also deletes all previously created prebuilds for that configuration. As a result, shortly after you delete a configuration, prebuilds generated by that configuration will no longer be available when you create a new codespace.\n\nAfter you delete a prebuild configuration, workflow runs for that configuration that have been queued or started will still run. They will be listed in the workflow run history, along with previously completed workflow runs.\n\n1. On the Codespaces page of your repository settings, click the ellipsis to the right of the prebuild configuration you want to delete.\n\n2. In the dropdown menu, click **Delete**.\n\n \n\n3. Click **OK** to confirm the deletion.\n\n## Manually trigger prebuilds\n\nIt may be useful to manually trigger a workflow run for a prebuild configuration. Generally, this is only necessary if you are debugging a problem with the workflow for a prebuild configuration.\n\n1. On the Codespaces page of your repository settings, click the ellipsis to the right of the prebuild configuration whose workflow you want to trigger.\n2. In the dropdown menu, click **Manually trigger**.\n\n \n\n## Further reading\n\n* [Troubleshooting prebuilds](/en/codespaces/troubleshooting/troubleshooting-prebuilds)"}