Skip to main content
Version: 1.12

Connections

Use Settings > Connections to connect GitHub, manage the repositories Godot Launcher can import, and approve access for publishing new projects. The Connections shortcut in the main navigation opens the same settings while the feature is new.

Public Git repositories do not need a connection. You can clone them from Projects > Add > Clone public Git repository. Connect GitHub when you want to select from repositories available to your GitHub App installation, including private repositories you have allowed it to access, or publish a new project to a private repository.

Connect GitHub​

  1. Open Settings > Connections.
  2. Select Connect GitHub.
  3. Select Continue in browser, authorise access in your normal browser, then return to the launcher.
  4. Select the personal account or organisation installations you want to keep. Use Select all to select every available installation, or Add account or organisation to grant access to another installation.
  5. Select Connect selected. The button shows how many connections you have selected. The launcher shows Connecting... while it saves your selection.
GitHub connection dialog explaining the browser authorisation stepGitHub connection dialog explaining the browser authorisation step GitHub connection chooser with one organisation selectedGitHub connection chooser with one organisation selected

Godot Launcher stores each selected installation under the GitHub user who authorised it. Add connection can authorise another GitHub user or another set of installations.

Connections settings with GitHub installations ready for repository importConnections settings with GitHub installations ready for repository import

Manage repository access​

Select Manage GitHub connections to see the saved installations and their status. Hover over an action icon or focus it with the keyboard to show its label. For each connection, you can:

  • select Manage repository access to review the GitHub App installation and change which repositories it can access;
  • reconnect when authorisation is no longer usable; or
  • disconnect the installation from the launcher.
GitHub connections drawer with repository access and disconnect actionsGitHub connections drawer with repository access and disconnect actions

By default, Disconnect removes the local connection. It does not uninstall the GitHub App or change its repository selection on GitHub. When disconnecting the last connection for a GitHub account, you can also choose Revoke and disconnect to revoke that GitHub authorisation on all Godot Launcher devices. Those devices will need to reconnect. Use Manage repository access when you want to change or revoke that GitHub-side access.

If the launcher reports Updated permissions required, select the recovery action wherever it appears, including when importing a repository or publishing a new project. The shared GitHub connection flow keeps you in the current task, so you can complete the browser flow and return to it. Existing import access can remain available while publishing stays disabled. GitHub shows the requested permission change before you approve it.

GitHub connection dialog offering recovery for a connection that needs authorisationGitHub connection dialog offering recovery for a connection that needs authorisation

Connection recovery​

  • If a connection needs authorisation again, select Reconnect and complete the browser flow with the same GitHub user. The launcher can direct you to this recovery from Connections, repository import, or new-project publishing.
  • If an installation is unavailable, open Manage repository access and confirm that the GitHub App is still installed and can access the repositories you expect.
  • If secure credential storage is unavailable, the launcher does not save the connection. On Linux, set up a compatible keyring service in your desktop session, fully restart the launcher, then try again.
  • Cancelling the browser flow or closing the chooser before selecting Connect selected leaves existing connections unchanged. Once saving has started, closing the dialog does not undo the save.
Linux credential storage: Automatic or Secret Service

On Linux, open Settings > Connections and expand Credential storage. Choose Automatic to let the launcher select secure credential storage, or Secret Service when your desktop session has a compatible Secret Service keyring. Select Save choice, then confirm the warning. Changing the choice can require you to reconnect GitHub, but it keeps your existing connection details.

After saving a choice that differs from the one used when the launcher started, select Restart now to apply it or Not now to restart later. If you select Not now, the setting keeps a restart-required message. A full restart means quitting Godot Launcher, including its system tray process, then opening it again.

Expanded Linux credential storage settings showing that secure storage is unavailableExpanded Linux credential storage settings showing that secure storage is unavailable

For unavailable storage, failed saves or launch overrides, see Linux credential storage troubleshooting.

See How GitHub Connections Are Protected for credential storage, permissions, and privacy behaviour. See Create Your First Project to publish a new project or Import a Git Repository to bring an existing repository into Godot Launcher.