Troubleshooting

Use this page as a starting point when something in Godot Launcher is not behaving as expected. The detailed steps live in the relevant workflow guides so each fix stays close to the feature it supports.

Installation and startup

• Windows install or upgrade issues: See Installing Godot Launcher with winget.
• Linux AppImage startup or Chromium sandbox errors: See Running Godot Launcher in No-Sandbox Mode on Linux.
• General installation steps by platform: See Installation.

Editors and project launch

• No editor is installed yet: Start with Installing Godot Editor.
• A project asks for an editor that is not installed: See Add an Existing Project.
• A project has a missing or invalid editor path: See Change Project Editor Version.
• A custom-built Godot editor cannot be registered or launched: See Custom-Built Godot Editors.

Git and Visual Studio Code

• Git is missing or not detected: See Installing Git.
• Git cannot create the first commit: See Using Git With Godot Launcher.
• VS Code is missing, moved, or not detected: See Visual Studio Code Setup for Godot.
• VS Code config files were invalid and recovered: See Visual Studio Code Setup for Godot.

Settings and updates

• Tool actions are disabled in project menus: See Project Tool Toggles.
• Launcher update download or retry problems: See Manage Launcher Updates.
• Manual update is required on rpm-ostree systems: See Manage Launcher Updates.
• System tray behavior is confusing: See System Tray.

Platform-specific behavior

• Windows symlink setup or UAC prompts: See Godot Launcher Symlink Support on Windows.
• winget cannot find or update the package: See Installing Godot Launcher with winget.
• Linux sandbox workaround questions: See Running Godot Launcher in No-Sandbox Mode on Linux.

Still need help?

• Visit Help & Support for official links.
• Join the community Discord to ask questions and share context.
• Open a GitHub issue from the launcher project if you have a reproducible bug.