GreenFediverse: Difference between revisions

3,640 bytes removed ,  2 years ago
m
no edit summary
m (text-corrections)
mNo edit summary
Line 34: Line 34:
<u>Database 1:</u> [https://www.thegreenwebfoundation.org/ The GreenWebFoundation]'s open database, the "Green Web API" [https://github.com/thegreenwebfoundation (GitHub]) works in such a way that it outputs the "green" status of a website. This is done by The GreenWebFoundation first using various machine-verifiable methods to determine the domain names, IP addresses or the [[wikipedia:Autonomous_system_(Internet)|autonomous system number]]. In addition, the GreenWebFoundation has built an independent certificate database, where operators of websites or web hosts, which can not be automated-machine recorded, can register - take a look at the [https://www.thegreenwebfoundation.org/what-you-need-to-register/ registration-process].  There, a "proof" in the form of a certificate can then be provided, i.e. a [https://api.thegreenwebfoundation.org/greencheckimage/joinfediverse.wiki?nocache=true badge] can be acquired. These registered servers and services can then be labeled, i.e. provided with the information that they operate with renewable energy or not. Website addresses can be queried in the front end via a "[https://www.thegreenwebfoundation.org/green-web-check/ Green Web Check]" search mask or via the API. Whether a "green" entry exists here, the API then outputs a status result with "green" or "gray". More information about the functionality of this API can be found [https://www.thegreenwebfoundation.org/news/introducing-the-green-web-foundation-partner-api/ here]. "The Green Web Foundation is a recognized not-for-profit organization registered in the Netherlands, that is run by a small group of dedicated volunteers located in Germany and The Netherlands." "Our strategy is simple: we use the existing protocols of the internet to understand where infrastructure is run, when we speak to the people running it to see how they power it. We then make these answers easy to look up, providing free online tools, APIs and open datasets, and helping people incorporate this information into their own services and analysis."[https://www.thegreenwebfoundation.org/our-story/ <nowiki>[citation]</nowiki>]
<u>Database 1:</u> [https://www.thegreenwebfoundation.org/ The GreenWebFoundation]'s open database, the "Green Web API" [https://github.com/thegreenwebfoundation (GitHub]) works in such a way that it outputs the "green" status of a website. This is done by The GreenWebFoundation first using various machine-verifiable methods to determine the domain names, IP addresses or the [[wikipedia:Autonomous_system_(Internet)|autonomous system number]]. In addition, the GreenWebFoundation has built an independent certificate database, where operators of websites or web hosts, which can not be automated-machine recorded, can register - take a look at the [https://www.thegreenwebfoundation.org/what-you-need-to-register/ registration-process].  There, a "proof" in the form of a certificate can then be provided, i.e. a [https://api.thegreenwebfoundation.org/greencheckimage/joinfediverse.wiki?nocache=true badge] can be acquired. These registered servers and services can then be labeled, i.e. provided with the information that they operate with renewable energy or not. Website addresses can be queried in the front end via a "[https://www.thegreenwebfoundation.org/green-web-check/ Green Web Check]" search mask or via the API. Whether a "green" entry exists here, the API then outputs a status result with "green" or "gray". More information about the functionality of this API can be found [https://www.thegreenwebfoundation.org/news/introducing-the-green-web-foundation-partner-api/ here]. "The Green Web Foundation is a recognized not-for-profit organization registered in the Netherlands, that is run by a small group of dedicated volunteers located in Germany and The Netherlands." "Our strategy is simple: we use the existing protocols of the internet to understand where infrastructure is run, when we speak to the people running it to see how they power it. We then make these answers easy to look up, providing free online tools, APIs and open datasets, and helping people incorporate this information into their own services and analysis."[https://www.thegreenwebfoundation.org/our-story/ <nowiki>[citation]</nowiki>]


<u>Database 2:</u> Another database we use is that of [https://the-federation.info/ the-federation],  (they are also on [https://socialhome.network/u/thefederation Socialhome] and [https://github.com/thefederationinfo/the-federation.info GitHub]). Using the API, which is also open, we get a list of all connected and [https://the-federation.info/info here registered] instances of the Fediverse. A single instance offer us more information with the "/nodeinfo/2.0", (e.g. https://chaos.social/nodeinfo/2.0). Here we get, for example, what kind of "software" (Mastodon, PeerTube, etc.) is used on an instance.
<u>Database 2:</u> Another database we use is that from [https://nodes.fediverse.party/ nodes.fediverse.party]. Using the API, which is also open, we get a list of all connected and crawled instances of the Fediverse. A single instance offer us more information with the "/nodeinfo/2.0", (e.g. https://chaos.social/nodeinfo/2.0). Here we get, for example, what kind of "software" (Mastodon, PeerTube, etc.) is used on an instance.


<u>Then the magic begins: The Data-Collider:</u>
<u>Then the magic begins: The Data-Collider:</u>


Then we let these two databases collide with each other. The script we wrote, which you can find on [https://codeberg.org/GreenFediverse/green-instances codeberg] then executes the command to green check all instances and provide the information we want to get in our list. The result is our [https://greenfediverse.codeberg.page/green-instances/ Green Instances List].
Then we let these two databases collide with each other. The script we wrote, which you can find on [https://codeberg.org/GreenFediverse/green-instances codeberg] then executes the command to green check all collected fediverse instances and provide the information we want to get in our list. The result is our [https://greenfediverse.codeberg.page/green-instances/ Green Instances List].


====2. Research: building a open knowledge database====
====2. Research: building a open knowledge database====
Line 102: Line 102:
</syntaxhighlight>But don't forget to add and document your research to the "additional-info" section, otherwise someone will set your green status back to gray, because there is no transparent research and proof. If a instance (server/data center) is marked as gray, this means that there were no result from The GreenWebFoundation API, technically it is a "0". When a instance is green, technically a "+1" was coming from the GWF. By the way, there is no -1 for a not green status, just "+1" and "0". At the moment, only single instances (not the entire webhoster) can be set to green. If you can't find your instance, you should visit https://the-federation.info/info and register your instance, because we fetch all instances via their API database. If you are registered there, but the The GreenWebFoundation won't give you a result for your instance, then the accept-list is the way.
</syntaxhighlight>But don't forget to add and document your research to the "additional-info" section, otherwise someone will set your green status back to gray, because there is no transparent research and proof. If a instance (server/data center) is marked as gray, this means that there were no result from The GreenWebFoundation API, technically it is a "0". When a instance is green, technically a "+1" was coming from the GWF. By the way, there is no -1 for a not green status, just "+1" and "0". At the moment, only single instances (not the entire webhoster) can be set to green. If you can't find your instance, you should visit https://the-federation.info/info and register your instance, because we fetch all instances via their API database. If you are registered there, but the The GreenWebFoundation won't give you a result for your instance, then the accept-list is the way.


== Register Fediverse Instances ==
== Fediverse Instances ==
In order for your Fediverse instance to be displayed in our [https://greenfediverse.codeberg.page/Green-instances/ GreenInstancesList], it must first be registered at [https://the-federation.info/info The-Federation.info].<blockquote>"How do I get my node listed? For registering your node with this site, go to<code><nowiki>https://the-federation.info/register/</nowiki><yournode.tld></code>. After some seconds, you will be redirected to the created node page. If this doesn't happen, something went wrong when checking the node for data. Please contact us using the GitHub issue tracker."</blockquote>First you should check to see if your instance is showing up in our [https://greenfediverse.codeberg.page/Green-instances/ GreenInstancesList]. To do this, you can open the search in your browser with Control+F and then search for your instance.
coming soon ...
 
You should know that we use and connect two databases. In the next step we will then check all these registered instances with the [https://www.thegreenwebfoundation.org/green-web-check/ Green Web Checker API] of The GreenWebFoundation. Here you can also check your instance individually via the Green Web Checker input mask.
 
If you run your own server at home, with your own hardware and with a renewable energy certificate, you can register your website (your instance address) at The GreenWebFoundation self-registration [https://admin.thegreenwebfoundation.org/registration/ member portal]. Many instances are already covered here by the large data centers, so it may be that if your instance lies on a large data center, this is already displayed.
 
There are also instances that are completely run locally at home with solar modules. 💚
 
In this case, you should also register your instance with [https://the-federation.info/info The-Federation.info] first. If your instance then appears in our [https://greenfediverse.codeberg.page/Green-instances/ GreenInstancesList], you can try to submit a proof through the GreenWebFoundation. We do not have any experience with this.
 
But you can then register your instance with us. First create an account at [https://codeberg.org/ Codeberg.org] for the access to our repository (it is a non-profit association from Berlin, you can follow them [https://mastodon.technology/@codeberg here]).
 
Then you have to make a few entries:
 
1. in the acceptlist in the [https://codeberg.org/GreenFediverse/green-instances/src/branch/master/acceptlist/instances.json instances.json]. This will mark your instance as "green".
 
2. if you want to add further information, i.e. "additional infos" for a certificate or explanation, then you should make an entry in the [https://codeberg.org/GreenFediverse/green-instances/src/branch/master/table.js table.js], under "const ADDITIONAL_INFO_LIST = {"
 
3. you also have to create your own additional-info file in this [https://codeberg.org/GreenFediverse/green-instances/src/branch/master/additional-info folder]. Please make sure that the filenames match everywhere.
 
4. you can add yourself as a webhoster in our [https://codeberg.org/GreenFediverse/green-instances/issues/14 overview].
 
We have already described this in more detail, as you can see above.
 
Some instances also disguise their location, the reasons can vary. "It could be blocking access to NodeInfo, or its address could be unreachable from the crawler’s host (as is the case with Tor and I2P addresses)."<ref>https://nodes.fediverse.party/</ref>. This means that it is technically no longer possible to determine the exact data center. This is then displayed in our list as "unknown".
 
== Interested to help with coding or research? ==
== Interested to help with coding or research? ==
Then create an account on [https://codeberg.org/ Codeberg.org] for working with us in our repository or get in touch with us on [https://chaos.social/@greenfediverse Mastodon] or in our room on [https://matrix.to/#/!hOSQzqvWebFkewbpwv:matrix.org?via=matrix.org&via=synod.im matrix].  
Then create an account on [https://codeberg.org/ Codeberg.org] for working with us in our repository or get in touch with us on [https://chaos.social/@greenfediverse Mastodon] or in our room on [https://matrix.to/#/!hOSQzqvWebFkewbpwv:matrix.org?via=matrix.org&via=synod.im matrix].  
Line 135: Line 110:


== Support ==
== Support ==
You can support and donate to the projects we work with:
You can buy us a ☕ on '''[https://ko-fi.com/greenfediverse ko-fi]'''
 
You can also support and donate to the projects we work with:


* [https://codeberg.org/ Codeberg.org] (infrastructure, repository)
* [https://chaos.social chaos.social] (mastodon account for communication)
*[https://codeberg.org/ Codeberg.org] (infrastructure, repository)
* [https://climatejustice.social/@PaulaToThePeople PaulaToThePeople] (infrastructure, joinfediverse.wiki)
* [https://climatejustice.social/@PaulaToThePeople PaulaToThePeople] (infrastructure, joinfediverse.wiki)
* [https://www.thegreenwebfoundation.org The GreenWebFoundation] (green database)
* [https://www.thegreenwebfoundation.org The GreenWebFoundation] (green web check database)
* [https://the-federation.info The-Federation.info] (instances database)
* [https://nodes.fediverse.party/ nodes.fediverse.party] (fediverse instances database)
*[https://chaos.social chaos.social] (mastodon account for communication)


Note: Please check out by yourself how to donate to these projects.
Note: Please check out by yourself how to donate to these projects.