Feature Request: Implement Nodeinfo endpoints for federation discovery #7725

New Issue

GiteaMirror · 2025-11-02T07:34:40-06:00

GiteaMirror commented

2025-11-02 07:34:40 -06:00

Originally created by @techknowlogick on GitHub (Aug 20, 2021).

Originally assigned to: @techknowlogick on GitHub.

Nodeinfo is a way to expose certain metadata about a server for use of discovery regarding functionality of its federation capabilities.

Two endpoints are required:

/.well-known/nodeinfo which informs client where it can find the location of the location of its metadata (including which version of the schema is used)
the endpoint which exposes the metadata in json format according to schema.

Notes:

openRegistrations is a required field, but I propose to set to false as default in case someone writes a crawler to discover "open" gitea instances
to limit data leakage I also propose to not include the usage field (note it is required so it should be included, but left as empty).

More info:
https://github.com/jhass/nodeinfo
https://github.com/jhass/nodeinfo/tree/main/schemas/2.1
http://nodeinfo.diaspora.software/protocol.html

cc: @pilou-

Originally created by @techknowlogick on GitHub (Aug 20, 2021). Originally assigned to: @techknowlogick on GitHub. Nodeinfo is a way to expose certain metadata about a server for use of discovery regarding functionality of its federation capabilities. Two endpoints are required: 1. `/.well-known/nodeinfo` which informs client where it can find the location of the location of its metadata (including which version of the schema is used) 2. the endpoint which exposes the metadata in json format according to schema. Notes: * `openRegistrations` is a required field, but I propose to set to false as default in case someone writes a crawler to discover "open" gitea instances * to limit data leakage I also propose to not include the `usage` field (note it is required so it should be included, but left as empty). More info: https://github.com/jhass/nodeinfo https://github.com/jhass/nodeinfo/tree/main/schemas/2.1 http://nodeinfo.diaspora.software/protocol.html cc: @pilou-

GiteaMirror added the type/proposal topic/federation labels 2025-11-02 07:34:40 -06:00

GiteaMirror closed this issue

2025-11-02 07:34:40 -06:00

GiteaMirror commented

2025-11-02 07:34:41 -06:00

@techknowlogick commented on GitHub (Sep 28, 2021):

I claim 2,500€ from the fedeproxy Gitea federation grant for the work I did to create this issue and implement the associated pull request, where 25% will be split among the reviewers, and 25% will go to the project (via opencollective).

@lunny / @lafriks do you approve this? (more info linked here: https://forum.fedeproxy.eu/t/howto-5-000-grant-earmarked-for-gitea-federation/330/17)

@techknowlogick commented on GitHub (Sep 28, 2021): I claim 2,500€ from the fedeproxy Gitea federation grant for the work I did to create this issue and implement the associated pull request, where 25% will be split among the reviewers, and 25% will go to the project (via opencollective). @lunny / @lafriks do you approve this? (more info linked here: https://forum.fedeproxy.eu/t/howto-5-000-grant-earmarked-for-gitea-federation/330/17)

GiteaMirror commented

2025-11-02 07:34:41 -06:00

@lafriks commented on GitHub (Sep 28, 2021):

I approve

@lafriks commented on GitHub (Sep 28, 2021): I approve

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/gitea#7725