mirror
/
gitea
mirror of https://github.com/go-gitea/gitea
2
0
Fork 0
Code Issues Releases Wiki Activity
Git with a cup of tea, painless self-hosted git service Mirror for internal git.with.parts use https://git.with.parts
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
5853 Commits
17 Branches
214 Tags
5.0 GiB
 
 
 
 
 
 
Tag: Branch: Tree: d39b88ae88
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'd39b88ae88'
${ noResults }
gitea/docs/content/doc/help/troubleshooting.en-us.md

2.1 KiB
Raw Blame History

date title slug weight toc draft menu
2016-11-08T16:00:00+02:00 Troubleshooting troubleshooting 10 true false [{sidebar [{parent Help} {name Troubleshooting} {weight 20} {identifier troubleshooting}]}]

Troubleshooting

This page contains some common issues you can run into and their solutions.

SSH issues

If you are having issues with reaching your repositories over ssh while the Gitea web front-end and https based git operations work fine, consider looking at the following items.

Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

This error signifies that the server rejected your log in attempt, check the following things:

  • On the client:
    • Ensure the public and private ssh keys are added to the correct Gitea user.
    • Make sure there are no issues in your remote url, ensure the name of the git user (before the @) is spelled correctly.
    • Ensure the public and private ssh keys are available and reachable on the client machine.
    • Try to ssh git@myremote.example to ensure that everything is set up properly.
  • On the server:
    • Check the permissions of the .ssh directory in the home directory of your git user.
    • Verify that the correct public keys are added to .ssh/authorized_keys. Try to run Rewrite '.ssh/authorized_keys' file (for Gitea SSH keys) on the Gitea admin panel.

If you get a similar error without the public key part (shown below) then authentication succeeded, but some other setting is preventing ssh from reaching the correct repository.

fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

In this case, look into the following settings:

  • On the server:
    • Make sure that your git user has a usable shell set. You can verify this with getent passwd git | cut -d: -f7, chsh can be used to modify this.
    • Ensure that the gitea serv command in .ssh/authorized_keys uses the proper configuration file.