Codeberg/Documentation

Fork 131

Git protocol not documented #731

New issue

Open

opened 2026-01-15 16:24:59 +01:00 by reynir · 4 comments

reynir commented

2026-01-15 16:24:59 +01:00

Contributor

On IRC a person was trying to clone a repository using the git protocol. I don't think this is supported by Codeberg, so I went to the documentation to try to confirm that, but I could not find it. I would expect it mentioned for example here: https://docs.codeberg.org/git/clone-commit-via-cli/

mahlzahn commented

2026-01-15 18:34:40 +01:00

Member

It has been deprecated even by Github in 2022 and luckily Forgejo does not provide this unsecure git:// protocol neither. I would also expect it to be mentioned in the linked docs if it were there. Does this solve your question?

It has been deprecated [even by Github in 2022](https://github.blog/security/application-security/improving-git-protocol-security-github/) and luckily Forgejo does not provide this unsecure `git://` protocol neither. I would also expect it to be mentioned in the linked docs if it were there. Does this solve your question?

reynir commented

2026-01-16 10:53:58 +01:00

Author

Contributor

Thanks for your reply. I agree that there are all sorts of valid reasons to not use the git protocol in Codeberg, and I'm not advocating that. I'm looking for an authoritative place in the docs I can point to explaining that git clone git://codeberg.org/Codeberg/Documentation.git will not work. Preferably without jumping through hoops explaining that Codeberg runs a (version of) Forgejo and this person says Forgejo "doesn't provide this unsecure git:// protocol".

Thanks for your reply. I agree that there are all sorts of valid reasons to not use the git protocol in Codeberg, and I'm not advocating that. I'm looking for an authoritative place in the docs I can point to explaining that `git clone git://codeberg.org/Codeberg/Documentation.git` will not work. Preferably without jumping through hoops explaining that Codeberg runs a (version of) Forgejo and [this person](https://codeberg.org/Codeberg/Documentation/issues/731#issuecomment-9888356) says Forgejo "doesn't provide this unsecure `git://` protocol".

danselmi commented

2026-02-14 20:15:35 +01:00

The docs seem suitable to me. The Clone section describes the two supported protocols. It does not describe unsupported protocols (git://, file://, others?).

A sentence could be added to say that there are 2 supported protocols if this were a common problem. Why did the IRC user think git:// would work?

[The docs](https://docs.codeberg.org/git/clone-commit-via-cli/#clone) seem suitable to me. The Clone section describes the two supported protocols. It does not describe unsupported protocols (git://, file://, others?). A sentence could be added to say that there are 2 supported protocols if this were a common problem. Why did the IRC user think git:// would work?

reynir commented

2026-02-19 13:56:13 +01:00

Author

Contributor

@danselmi wrote in #731 (comment):

A sentence could be added to say that there are 2 supported protocols if this were a common problem. Why did the IRC user think git:// would work?

I can't say. But if you're not an expert maybe it's not so unreasonable to think that git uses the git protocol? I don't know.

@danselmi wrote in https://codeberg.org/Codeberg/Documentation/issues/731#issuecomment-10590134: > A sentence could be added to say that there are 2 supported protocols if this were a common problem. Why did the IRC user think git:// would work? I can't say. But if you're not an expert maybe it's not so unreasonable to think that git uses the **git** protocol? I don't know.

No milestone

No project

No assignees

3 participants

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

Codeberg/Documentation#731

No description provided.

Rows
Columns