Skip to main content

Restricting the idle timeout period

You can set a maximum timeout period for any codespaces owned by your organization.

To manage timeout constraints for an organization's codespaces, you must be an owner of the organization.

Codespaces está disponible para las organizaciones que utilicen GitHub Team o Nube de GitHub Enterprise. Para obtener más información, consulta la sección "Productos de GitHub".


By default, codespaces time out after 30 minutes of inactivity. When a codespace times out it is stopped and will no longer incur charges for compute usage.

The personal settings of a GitHub user allow them to define their own timeout period for codespaces they create. This may be longer than the default 30-minute period. For more information, see "Setting your timeout period for Codespaces."

As an organization owner, you may want to configure constraints on the maximum idle timeout period for codespaces created for repositories owned by your organization. This can help you to limit costs associated with codespaces that are left to timeout after long periods of inactivity. You can set a maximum timeout for the codespaces for all repositories owned by your organization, or for the codespaces of specific repositories.

Note: Maximum idle timeout constraints only apply to codespaces that are owned by your organization.

For more information about pricing for Codespaces compute usage, see "About billing for Codespaces."

Behavior when you set a maximum idle timeout constraint

If someone sets the default idle timeout to 90 minutes in their personal settings and they then start a codespace for a repository with a maximum idle timeout constraint of 60 minutes, the codespace will time out after 60 minutes of inactivity. When codespace creation completes, a message explaining this will be displayed:

Idle timeout for this codespace is set to 60 minutes in compliance with your organization’s policy.

Configurar políticas específicas para los repositorios y a lo largo de la organización

When you create a policy, you choose whether it applies to all repositories in your organization, or only to specified repositories. If you create an organization-wide policy with a timeout constraint, then the timeout constraints in any policies that are targeted at specific repositories must fall within the restriction configured for the entire organization. The shortest timeout period - in an organization-wide policy, a policy targeted at specified repositories, or in someone's personal settings - is applied.

If you add an organization-wide policy with a timeout constraint, you should set the timeout to the longest acceptable period. You can then add separate policies that set the maximum timeout to a shorter period for specific repositories in your organization.

Adding a policy to set a maximum idle timeout period

  1. En la esquina superior derecha de, haz clic en tu foto de perfil y luego en Tus organizaciones. Tus organizaciones en el menú de perfil

  2. Junto a la organización, haz clic en Configuración. El botón de configuración

  3. In the "Code, planning, and automation" section of the sidebar, select Codespaces then click Policies.

  4. En la página de "Políticas de los codespaces", haz clic en Crear política.

  5. Ingresa un nombre para tu política nueva.

  6. Click Add constraint and choose Maximum idle timeout.

    Add a constraint for idle timeout

  7. Haz clic en para editar la restricción.

    Edit the timeout constraint

  8. Enter the maximum number of minutes codespaces can remain inactive before they time out, then click Save.

    Set the maximum timeout in minutes

  9. En el área de "Cambiar destino de la política", haz clic en el botón desplegable.

  10. Elige y asea Todos los repositorios o Repositorios seleccionados para determinar a cuáles aplicará esta política.

  11. Si eliges Repositorios seleccionados:

    1. Da clic en .

      Editar los ajustes para la política

    2. Selecciona los repositorios a los cuales quieres que aplique esta política.

    3. En la parte inferior de la lista de repositorios, haz clic en Seleccionar repositorios.

      Selecciona los repositorios para esta política

  12. Si quieres agregar otra restricción a la política, haz clic en Agregar restricción y elige otra de ellas. Para obtener información sobre otras restricciones, consulta las secciones "Restringir el acceso a los tipos de máquina", "Restringir la visibilidad de los puertos reenviados" y "Restringir el periodo de retención para los codespaces".

  13. After you've finished adding constraints to your policy, click Save.

The policy will be applied to all new codespaces that are created, and to existing codespaces the next time they are started.

Editar una política

You can edit an existing policy. Por ejemplo, puede que quieras agregar o eliminar restricciones hacia o desde una política.

  1. Muestra la página de "Políticas del Codespace". For more information, see "Adding a policy to set a maximum idle timeout period."
  2. Haz clic en el nombre de la política que quieres editar.
  3. Haz los cambios requeridos y luego haz clic en Guardar.

Borrar una política

  1. Muestra la página de "Políticas del Codespace". For more information, see "Adding a policy to set a maximum idle timeout period."

  2. Haz clic en el botón de borrar a la derecha de la política que quieras borrar.

    El botón de borrar para una política