Skip to content

Commit a88b7bd

Browse files
authored
doc: Revise instance rules for compliance and stability (#686)
* doc: Revise instance rules for compliance and stability Updated rules for instances to include new requirements on playback stability and IP rotation due to YouTube blocking more aggressively public instances. * docs: Clarify HTTPS requirement for instances
1 parent 49c95ec commit a88b7bd

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

docs/instances.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,14 +24,16 @@
2424

2525
## Rules to have your instance in this list:
2626

27+
Instance operators SHOULD [contact the Invidious maintainers](https://invidious.io/contact/) for guidance only if they are unsure how to comply with a specific rule or set of rules, such as questions about rotating proxies, anti-bot measures, monitoring, or Invidious configuration.
28+
2729
1. Instances MUST have been up for at least a month before it can be added to this list.
2830
2. Instances MUST not be more than a month out of date compared with either the latest commit or latest release. Any instance that is more than a month out of date is considered unmaintained and will be removed from the list.
2931
3. Instances MUST have statistics (`/api/v1/stats`) enabled (`statistics_enabled: true` in the configuration file).
3032
4. Instances MUST have an uptime of at least 90% ([according to uptime.invidious.io](https://uptime.invidious.io/)).
31-
5. Instances MUST be served via domain name.
32-
6. Instances MUST be served via HTTPS (or/and onion).
33-
7. Instances using any DDoS Protection / MITM MUST be marked as such (e.g. Cloudflare, DDoS-Guard).
34-
8. Instances using any type of anti-bot protection MUST be marked as such.
33+
5. Instances MUST demonstrate good playback stability, as evaluated manually by the Invidious maintainers.
34+
6. Instances MUST be served via domain name.
35+
7. Instances MUST be served via HTTPS on the clearnet (internet).
36+
8. Instances using any DDoS Protection / MITM MUST be marked as such (e.g. Cloudflare, DDoS-Guard).
3537
9. Instances MUST NOT use any type of analytics, including external scripts of any kind.
3638
10. Any system whose goal is to modify the content served to the user (i.e web server HTML rewrite) is considered the same as modifying the source code.
3739
11. Instances running a modified source code:
@@ -40,5 +42,8 @@
4042
- MUST contain a link to both the modified and original source code of Invidious in the footer.
4143
12. Instances MUST NOT serve ads (sponsorship links in the banner are considered ads) NOR promote products.
4244
13. Instances MUST NOT restrict or disallow the access / usage to any [natural person](https://en.wikipedia.org/wiki/Natural_person) (e.g. a country's IP range MUST NOT be blocked, access by a natural person MUST NOT be disallowed for arbitrary reason) - this rule doesn't apply to [juridical persons](https://en.wikipedia.org/wiki/Juridical_person).
45+
14. Public instances MUST deploy effective measures to limit automated or abusive traffic (e.g., anti-bot systems, rate limiting, challenge-based access controls). These measures are required to preserve playback stability, performance, and service availability for legitimate users.
46+
15. Public instances MUST use a system that rotates the IP addresses used for communication with YouTube’s servers (for example, rotating proxy infrastructure). Static or single-IP setups are not considered sufficient for a public instance.
47+
16. Public instances MUST provide users with an experience that is as close as reasonably possible to the default (“vanilla”) feature set of the Invidious software. Deliberately disabling, degrading, or restricting core features (including but not limited to video quality options) is not permitted for public instances. Exceptions may be granted only at the maintainers’ discretion, and approval must be explicit.
4348

4449
**NOTE:** We reserve the right to decline any instance from being added to the list, and to remove / ban any instance breaking the aforementioned rules.

0 commit comments

Comments
 (0)