mybinder.org Usage Guidelines¶
This page details some guidelines and policies that we follow at
When in doubt, open an issue
If you’re not sure whether your use-case is reasonable for
hesitate to open an issue
to ask if your planned usage is OK.
Temporary banning means that
mybinder.org will stop building / serving Binder
sessions for a given repository. This usually happens because of some
undesired behavior with the repository. Some examples of behavior that could
result in temporary banning include:
A large, unexpected spike in traffic that persists over time.
Sessions that routinely use a large amount of CPU.
Sessions that attempt to perform a lot of outgoing networking traffic.
mybinder.org team uses the following workflow in discussing / deciding
when to temporarily ban a repository:
An issue is created to document why a repo (or group of repos) is being banned
A PR that implements the ban is opened
A “bans” tag notes any PRs that created a ban
The issue stays open until the ban is lifted
Running events with
If you’d like to run an event with
mybinder.org and expect more than 100 users
to join at once, please request an increase in quota for your repository.
The Binder Team occasionally increases the number of sessions that can run for a single repository if it is being used for purposes that align with the mission of the Binder Project. However, there is no guarantee that this will be done for your event.
Maximum Concurrent Users for a Repository¶
We don’t want a single repository to dominate all of the traffic to Binder, so we’ve set a maximum limit of concurrent user sessions that point to the same Binder link. The maximum number of simultaneous users for a given repo is 100. If you think you have a really good reason for why this number should be higher, please Open an Issue. to discuss with the community!
Using mybinder.org as backend for your service¶
A note on for-profit services
Please do not use
mybinder.org as backend for your for-profit service or product.
The cloud resources consumed by
mybinder.org are funded through donations or grants. Because of this we can not subsidise for-profit products or services by offering free cloud resources to them. This means we will prevent you from using
mybinder.org as a service for your product.
mybinder.org relies on the good will of volunteers and organisations to obtain the
resources required to do so. This is easier if we are not seen as supporting for-profit services
that are not a net contributor to the service.
You may be considering using
mybinder.org as a part of your service or product. We think that is great, and encourage people to experiment with using Binder technology as a part of their tools.
However, depending on the size and consistency of traffic being directed at
mybinder.org, we may restrict your usage of the
mybinder.org service in order to avoid being overloaded by a single user / organization. This is particularly true for services that trigger many repository builds.
In general, please be respectful of the Binder Project’s limited resources. Do not forget that it has no dedicated funding and runs entirely on donations of cloud resources. If you have a question about this, please Open an Issue.