In this chapterFind a practical next step for a common problem.
| Problem | What to do |
|---|---|
| “Permission denied (publickey)” | Check the account’s status on the Accounts page; use its fix button. Run gittrail doctor --ssh in the repo. Make sure the SSH key is added to the host. |
| Commits show the wrong author | Check where the repo’s account comes from (gittrail current). Add a folder or remote rule. For unpushed commits, use Fix wrong authors. |
| HTTPS asks for a password | Save a token for the account, or switch the remote to SSH with gittrail fix. |
| “Host key changed” warning | Open Account › Host key: GitTrail explains it and replaces it only when it matches the host’s published key. |
| Push refused by the push check | The repo’s account doesn’t match the remote. Pick the right account, then push again. |
“To pull” shows ? |
The repo hasn’t been checked for an hour. Click Fetch or Check all for updates. |
| Something went wrong | Settings › Copy error report collects the details for a bug report. |
| The app won’t open its window | Try gittrail ui --window chromium or --window browser. |
Need another approach?Find a fix →