Skip to main content

GitHub Codespaces logs

Overview of the logs used by GitHub Codespaces.

Information on GitHub Codespaces is output to various logs:

  • Codespace logs
  • Creation logs
  • Browser console logs (for the VS Code web client)

Extension logs are available if you are using GitHub Codespaces in VS Code. Click the "Visual Studio Code" tab above for details.

  • Codespace logs
  • Creation logs
  • Extension logs (for the VS Code desktop application)

Browser logs are available if you are using GitHub Codespaces in your browser. Click the "Web browser" tab above for details.

  • Codespace logs
  • Creation logs

Other logs are available if you are using GitHub Codespaces in VS Code or in your web browser. Click the tabs above for details.

Codespace logs

These logs contain detailed information about the codespace, the container, the session, and the VS Code environment. They are useful for diagnosing connection issues and other unexpected behavior. For example, the codespace freezes but the "Reload Windows" option unfreezes it for a few minutes, or you are randomly disconnected from the codespace but able to reconnect immediately.

  1. If you are using GitHub Codespaces in the browser, ensure that you are connected to the codespace you want to debug.
  2. Open the VS Code Command Palette (Shift+Command+P (Mac) / Ctrl+Shift+P (Windows/Linux)) and type export logs. Select Codespaces: Export Logs from the list to download the logs.
  3. Define where to save the zip archive of logs then click Save (desktop) or click OK (web).
  4. If you are using GitHub Codespaces in the browser, right-click on the zip archive of logs from the Explorer view and select Download… to download them to your local machine.

Codespace logs

These logs contain detailed information about the codespace, the container, the session, and the VS Code environment. They are useful for diagnosing connection issues and other unexpected behavior. For example, the codespace freezes but the "Reload Windows" option unfreezes it for a few minutes, or you are randomly disconnected from the codespace but able to reconnect immediately.

  1. Open the VS Code Command Palette (Shift+Command+P (Mac) / Ctrl+Shift+