Help
How to seek help, a list of common issues and solutions, and how to report a bug or request a feature.
Ghostty is a personal side project with no commercial backing. As such, there is no support team or dedicated resources to help you. The community is very helpful and may provide assistance, and we try to document as many common issues and solutions as possible.
| Issue | Solution |
|---|---|
| Error "missing or unsuitable terminal" when running commands or using SSH. | Terminfo |
| macOS window managers such as Yabai or Aerospace act strange | macOS Tiling Window Managers |
| Ghostty has slow startup or high memory usage on Linux. | GTK Single Instance |
| macOS defaults to login shells | macOS Login Shells |
If the common issues and solutions above did not help and you can't find an answer in the documentation, the following resources are available:
Please, please, please read the contributing guide on GitHub.
Important
GitHub Issues is probably not the right place to go. This project starts all bugs and feature requests as discussions on GitHub Discussions until more specific details are known. From there, we convert them into GitHub Issues as needed. See the contributing guide for more details.