# PeerTube

PeerTube is a free, open-source, decentralized, and federated video platform. It allows you to host your own video content on your own server, using ActivityPub federation to connect with other PeerTube instances across the fediverse.

> [!NOTE]
>
> **Info**
>
> PeerTube is an open-source tool. ElfHosted provides hosting infrastructure only. Users are responsible for their use of this service in compliance with applicable laws and third-party terms of service.

[Get a 7-day trial of ElfHosted PeerTube! 🪄](<https://store.elfhosted.com/product/peertube/>)

## How do I access PeerTube?

PeerTube is available:

- From your dashboard: [https://your-username.elfhosted.com](<https://your-username.elfhosted.com>)
- Directly: [https://your-username-peertube.elfhosted.com](<https://your-username-peertube.elfhosted.com>)

> [!NOTE]
>
> **Signed-in users see their own URLs**
>
> The addresses above show the general pattern. [Sign in](<https://docs-internal.elfhosted.com/app/peertube/>) and these become your personal, clickable links.

## Common use cases

PeerTube is designed for organizing and streaming your personal media collection, including:

- **Personal home videos and photos**: Organize and stream your family memories from any device
- **Content you own**: Manage media from your Blu-rays, DVDs, and digital purchases you've legally backed up
- **Public domain media**: Access classic films, educational content, and historical recordings
- **Creative Commons content**: Host CC-licensed documentaries, podcasts, and independent films
- **Personal recordings**: Store and stream recordings from over-the-air broadcasts (*where legally permitted*)
- **Home media projects**: Share your own creative video projects with family and friends

Users are solely responsible for ensuring all content in their PeerTube library complies with applicable copyright laws.

## How do I use it?

### Set PEERTUBE\_SECRET

PeerTube won't start without a `PEERTUBE_SECRET` ENV var, which needs to be set by the user.

Generate a 64-character hexidecimal string (*`openssl rand -hex 32` for example*), and then applying it to PeerTube using [ElfBot](<https://docs-internal.elfhosted.com/app/elfbot/>):

Quick-paste into PeerTube's environment variables using ElfBot

```
PEERTUBE_SECRET=whateveryousetmakesureits64charshexidecimalonly
```

### Connect the PeerTube Runner

If you have the PeerTube Runner, it takes transcoding jobs off your PeerTube. It registers itself with your PeerTube when it starts, using two environment variables set on the **PeerTube Runner** card in [ElfBot](<https://docs-internal.elfhosted.com/app/elfbot/>):

1. In PeerTube, go to **Administration** \> **Settings** \> **Runners** \> **Registration tokens**, and copy a token.
2. In ElfBot, open the **...** menu on the PeerTube Runner card, choose **Environment Variables**, and add:

Quick-paste into PeerTube Runner's environment variables using ElfBot

```
PEERTUBE_RUNNER_URL=https://your-peertube-address
PEERTUBE_RUNNER_TOKEN=your-registration-token
```

The runner restarts and registers. Its page shows "Registered with" and your PeerTube's address once it's done, or "Registration failed" if PeerTube refused the token. Set `PEERTUBE_RUNNER_NAME` too if you'd like it listed under a name other than `elfhosted`.

## How do I get support for PeerTube?

1. For general use of PeerTube, refer to the [official site](<https://joinpeertube.org>) or to one of the links in the resources section below.
2. For specific support re your ElfHosted configuration / account, see the [ElfHosted support options](</get-help/>)!

## Sponsor PeerTube ❤️

You can contribute directly to the development of PeerTube using the following:

- [Support PeerTube](<https://joinpeertube.org/support>)

## PeerTube resources

- [PeerTube (*official site*)](<https://joinpeertube.org>)
- [PeerTube GitHub Repo](<https://github.com/Chocobozzz/PeerTube>)
- [PeerTube Documentation](<https://docs.joinpeertube.org/>)
