Skip to main content

Setting your timeout period for GitHub Codespaces

You can set your default timeout for GitHub Codespaces in your personal settings page.

About the idle timeout

A codespace will stop running after a period of inactivity. By default this period is 30 minutes, but you can specify a longer or shorter default timeout period in your personal settings on GitHub. The updated setting will apply to any new codespaces you create, or to existing codespaces the next time you start them. You can also specify a timeout when you use GitHub CLI to create a codespace.

Warning: Codespaces compute usage is billed for the duration for which a codespace is active. If you're not using a codespace but it remains running, and hasn't yet timed out, you are billed for the total time that the codespace was active, irrespective of whether you were using it. For more information, see "Informationen zur Abrechnung für GitHub Codespaces."

Inactivity defined

Im Kontext der Codespaces-Leerlauftimeouts wird die Inaktivität als fehlende Aktivität definiert, die auf die Anwesenheit eines Benutzers hinweist. Persönliche Interaktion mit einem Codespace, z. B. Eingabe oder Verwendung der Maus, setzt den Zeitraum des Leerlauftimeouts zurück. Die Terminalaktivität, entweder Eingabe oder Ausgabe, setzt ebenfalls den Zeitraum des Leerlauftimeouts zurück. Wenn Sie beispielsweise eine Web-App auf einem Port aus einem Codespace veröffentlichen und Seitenanforderungen die Ausgabe in einem Terminal im Codespace generieren, wird jedes Mal, wenn die Terminalausgabe auftritt, das Timeout zurückgesetzt. Wenn Sie jedoch einen Port freigeben und dann nicht mit dem Codespace interagieren und keine Terminalausgabe generiert wird, tritt ein Timeout für den Codespace nach dem konfigurierten Zeitraum auf.

Timeout periods for organization-owned repositories

Organizations can set a maximum idle timeout policy for codespaces created from some or all of their repositories. If an organization policy sets a maximum timeout which is less than the default timeout you have set, the organization's timeout will be used instead of your setting. You will be notified of this after the codespace is created. For more information, see "Einschränken des Zeitraums für Leerlauftimeouts."

Setting your default timeout period

  1. Klicke auf einer beliebigen Seite in der oberen rechten Ecke auf dein Profilfoto und anschließend auf Einstellungen.

    Screenshot of a user's account menu on GitHub. The menu item "Settings" is outlined in dark orange.

  2. Klicke im Abschnitt „Code, Planung und Automatisierung“ der Seitenleiste auf Codespaces.

  3. Under "Default idle timeout", enter the time that you want, then click Save. The time must be between 5 minutes and 240 minutes (4 hours).

    Screenshot of the "Default idle timeout" section of the Codespaces settings, with "90 minutes" entered.

Setting the timeout period for a codespace

Weitere Informationen zur GitHub CLI findest du unter Informationen zur GitHub CLI.

To set the timeout period when you create a codespace, use the idle-timeout argument with the codespace create subcommand. Specify the time in minutes, followed by m. The time must be between 5 minutes and 240 minutes (4 hours).

gh codespace create --idle-timeout 90m

If you don't specify a timeout period when you create a codespace, then the default timeout period will be used. For information about setting a default timeout period, click the "Web browser" tab on this page. You can't currently specify a default timeout period through GitHub CLI.

Setting a timeout period

You can set your default timeout period in your web browser, on GitHub.com. Alternatively, if you use GitHub CLI to create a codespace you can set a timeout period for that particular codespace. For more information, click the appropriate tab above.

Further reading