PeerTube: first steps with your platform

← All guides

Your PeerTube platform is up and running, and you are its administrator. This guide covers the first steps: signing in, setting up the platform, deciding who can upload videos, moderating, and connecting to the Fediverse.

Step 1: Sign in and set your password

I don’t send you a password. You set it yourself:

  • Open your platform and click Login.
  • Click I forgot my password and enter the email address from your order.
  • You’ll receive an email with a link. Use it to set your password, then log in.

Then turn on two-factor authentication: open My account → Settings via your profile picture and, in the Two factor authentication section, enable it. Scan the QR code with an authenticator app.

Important: Your account is the administrator account of the whole platform. Without two-factor authentication, a guessed password is enough to take over everything.

Step 2: Set up the platform

You find the settings under Administration → Settings → Configuration. These tabs matter most:

  • Information: Name, Short description and Description of your platform, plus Terms, Code of conduct and Moderation information. If you run a public platform in Germany, add your imprint (Impressum) under Who is behind the instance?. This is also where you turn on the contact form and set the Policy on videos containing sensitive content.
  • Customization and Homepage: the look and start page of your platform.

I’ve set up the VOD, Live and Advanced tabs to match your server. Please only change them after checking with me: converting videos into several resolutions needs a lot of computing power and storage.

Step 3: Decide who can upload videos

When I hand the platform over, nobody can sign up on their own. For a small group, the easiest way is to create accounts yourself: Administration → Overview → Users → Create user. There you set the Role (Administrator, Moderator or User) and how much someone can upload (Video quota and Daily video quota).

If you want others to sign up themselves, you find the switches under Configuration → General:

  • Enable Signup opens registration.
  • Signup requires approval by moderators: keep this on. New sign-ups then appear under Administration → Moderation → Registrations, and you approve them yourself.
  • Signup requires email verification and Signup limit add extra protection against spam.
  • With Default video quota for a new user and Default daily upload limit for a new user, you limit how much new accounts can upload.

Important: Never leave registration fully open. Open video platforms are quickly abused for spam and other people’s content, and you are responsible for it.

Step 4: Connect to the Fediverse

Your channels are visible in the Fediverse. Anyone with an account on Mastodon and similar services can follow a channel at @channelname@your-domain and see new videos in their own timeline.

  • Under Administration → Settings → Federation, you see which platforms you follow (Following) and who follows you (Followers). If you follow other PeerTube platforms, their videos also appear on yours.
  • Under Configuration → General, you decide whether Remote actors can follow your platform and whether to Manually approve new followers that follow your platform.
  • Keep Automatically follow back followers that follow your platform and Automatically follow platforms of a public index turned off. Otherwise you pull unchecked videos from other platforms onto yours.

Moderation

  • Administration → Moderation → Reports: reports about videos, comments and accounts end up here.
  • Video blocks: videos you have blocked.
  • Muted accounts and Muted servers: hide individual accounts or entire servers.
  • Watched words: comments containing certain words are flagged automatically.
  • Under Administration → Overview, you find all Videos and Comments on your platform.

Keep an eye on storage

Every video is stored in several resolutions, so it takes up much more space than the uploaded file. Limit the Video quota of your users so that all of them together cannot use more than you booked.

Important: Keep Video redundancies turned off. Otherwise your platform also stores copies of other platforms’ videos. If you’re running low on storage, let me know before it’s full.

Apps

PeerTube works best in the browser. For watching, there is also the official PeerTube app for Android and iOS. Uploading and managing is easiest in the browser.

What I take care of

  • Updates of PeerTube and the server
  • Daily backups
  • Email delivery, HTTPS certificate and video conversion

If something doesn’t work, write to me at support@weingaertner-it.de.