YunoHost-Apps/peertube_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/peertube_ynh.git synced 2024-09-03 19:56:29 +02:00
Code Issues Activity Actions
peertube_ynh/README.md
anmol26s 63e285f5e5
Making readme ready for the master merge.
2018-06-05 19:43:58 +05:30

3.8 KiB
Raw Blame History

PeerTube app for YunoHost

Install Peertube with YunoHost

Shipped Version: 1.0.0-beta.7

PeerTube is a decentralized video streaming platform using P2P (BitTorrent) directly in the web browser, using WebTorrent.

PeerTube is sponsored by Framasoft, a non-profit that promotes, spreads and develops free-libre software. If you want to support this project, please consider donating them.

Demonstration

Want to see in action?

  • Demo
  • Video to see how the "decentralization feature" looks like
  • Video showcasing A2HS

Installation

Guidelines

  1. Require dedicated domain like peertube.domain.tld.
  2. No LDAP support (blocked until upstream implements it)
  3. URL can not be changed once selected.
  4. Take notice that this YunoHost package claims the following features:
  • Install
  • Remove
  • Upgrade
  • Backup
  • Restore
  • Multi-instance

Install

  1. App can be installed by YunoHost admin interface or by the following command:

     $ sudo yunohost app install https://github.com/YunoHost-Apps/peertube_ynh

  2. root is the admin username.

  3. root Password will be sent to the email address given at the time of the installation.

  4. TLS and starttls are disabled for the outgoing mails. If you intent to use email address not hosted on your local server,it's advised to have a proper SMTP configured with tls and starttls settings by editing /var/www/peertube/config/porduction.yml.

Updation

  1. App can be updated by YunoHost admin interface or by the following command:

      $ sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/peertube_ynh peertube

  2. App will backup the home directory for Peertube before updating which can take a lot of space on the system. It's advised to check the home folder's free space by

    $ df -h "/home" |  awk 'NR==2 { print $4 }'

and comapre it with space occupied by the Peertube home directory before updating.

    $ du -hcs /home/yunohost.app/peertube | awk 'NR==2 { print $1 }'

Why

We can't build a FOSS video streaming alternatives to YouTube, Dailymotion, Vimeo... with a centralized software. One organization alone cannot have enough money to pay bandwidth and video storage of its server.

So we need to have a decentralized network (as Hubzilla (Hubzilla YunoHost), Friendica (Friendica YunoHost), Mastodon (Mastodon YunoHost), Diaspora (Diaspora YunoHost),Funkwhale (Funkwhale YunoHost)). But it's not enough because one video could become famous and overload the server. It's the reason why we need to use a P2P protocol to limit the server load. Thanks to WebTorrent, we can make P2P (thus bittorrent) inside the web browser right now.

Dependencies

  • NodeJS, PostgreSQL.
  • On Debian Jessie,backport is added for the ffmpeg package.

LICENSE

PeerTube is licensed under the GNU Affero General Public License v3.0.