2016-02-26 01:17:30 +01:00
# Chihaya
[](https://travis-ci.org/chihaya/chihaya)
[](https://quay.io/repository/jzelinskie/chihaya)
[](https://godoc.org/github.com/chihaya/chihaya)
[](https://en.wikipedia.org/wiki/BSD_licenses#2-clause_license_.28.22Simplified_BSD_License.22_or_.22FreeBSD_License.22.29)
[](http://webchat.freenode.net/?channels=chihaya)
Chihaya is an open source [BitTorrent tracker] written in [Go].
Differentiating features include:
2016-03-05 17:09:28 +01:00
- Protocol-agnostic and middleware-composed logic
- Low resource consumption and fast, asynchronous request processing
- Unified IPv4 and IPv6 [swarms]
- [YAML] configuration
- Optional metrics via [Prometheus]
2016-02-26 01:17:30 +01:00
[BitTorrent tracker]: http://en.wikipedia.org/wiki/BitTorrent_tracker
[Go]: https://golang.org
2016-03-05 17:09:28 +01:00
[swarms]: https://en.wikipedia.org/wiki/Glossary_of_BitTorrent_terms#Swarm
2016-02-26 01:17:30 +01:00
[YAML]: http://yaml.org
2016-03-05 17:09:28 +01:00
[Prometheus]: http://prometheus.io
2016-02-26 01:17:30 +01:00
2016-03-30 06:38:57 +02:00
## Production Use
### Facebook
2016-03-30 06:45:59 +02:00
[Facebook] uses BitTorrent to deploy new versions of their software.
2016-03-30 06:38:57 +02:00
In order to optimize the flow of traffic within their datacenters, Chihaya is configured to prefer peers within the same subnet.
2016-03-30 06:45:59 +02:00
Because Facebook organizes their network such that server racks are allocated IP addresses in the same subnet, the vast majority of deployment traffic never impacts the congested areas of their network.
2016-03-30 06:38:57 +02:00
[Facebook]: https://facebook.com
### CoreOS
2016-03-30 06:45:59 +02:00
[Quay] is a container registry that offers the ability to download containers via BitTorrent in order to speed up large or geographically distant deployments.
2016-03-30 06:38:57 +02:00
Announce URLs from Quay's torrent files contain a [JWT] in order to allow Chihaya to verify that an infohash was approved by the registry.
2016-03-30 06:45:59 +02:00
By verifying the infohash, Quay can be sure that only their content is being shared by their tracker.
2016-03-30 06:38:57 +02:00
[Quay]: https://quay.io
[JWT]: https://jwt.io
2016-02-26 01:17:30 +01:00
## Getting Started
2016-03-05 17:09:28 +01:00
In order to compile the project, the latest stable version of Go and a working Go environment are required.
```sh
$ go get github.com/chihaya/chihaya
$ go install github.com/chihaya/chihaya/cmd/chihaya
```
2016-02-26 01:17:30 +01:00
## Development
Long-term discussion and bug reports are maintained via [GitHub Issues].
Code review is done via [GitHub Pull Requests].
2016-03-05 17:09:28 +01:00
Real-time discussion is done via [freenode IRC].
2016-02-26 01:17:30 +01:00
2016-03-30 07:21:53 +02:00
For more information read [CONTRIBUTING.md].
2016-02-26 01:17:30 +01:00
[GitHub Issues]: https://github.com/chihaya/chihaya/issues
[GitHub Pull Requests]: https://github.com/chihaya/chihaya/pulls
2016-03-05 17:09:28 +01:00
[freenode IRC]: http://webchat.freenode.net/?channels=chihaya
2016-03-30 07:21:53 +02:00
[CONTRIBUTING.md]: https://github.com/chihaya/chihaya/blob/master/CONTRIBUTING.md
2016-02-26 01:17:30 +01:00
## Related projects
- [OpenTracker ](http://erdgeist.org/arts/software/opentracker ): a popular BitTorrent tracker written in C
- [Ocelot ](https://github.com/WhatCD/Ocelot ): a private BitTorrent tracker written in C++
## License
Chihaya is distributed under the 2-Clause BSD license that can be found in the `LICENSE` file.
