Configuring A PeerTube Instance

Summary

This tutorial walks through the main steps for configuring a new PeerTube instance, using a FediHost-managed instance as the example. It focuses on practical setup choices for a single user or a small group of trusted users.

Account and profile setup

• Create a user account instead of publishing as the default root administrator.
• PeerTube separates users from channels. The user is the main account that publishes videos, while channels work more like playlists or categories and can help share that user’s videos across the Fediverse.
• Add a profile picture, display name, and description early so activity shared through ActivityPub has an identifiable profile.

Homepage and instance information

• PeerTube’s homepage content and landing page are separate settings. Adding custom homepage content does not make it the default page; you must also change the landing-page setting.
• The homepage can use built-in video listings or custom HTML elements, such as a banner, headings, featured videos, and video lists.
• Instance information includes its name, description, categories, and content-display choices. For potentially sensitive content, administrators can choose to hide or blur thumbnails.
• If other users will host videos on the instance, provide terms of service and a code of conduct.

Signups, comments, and federation

• The presenter recommends keeping signups disabled at first. Opening registration can increase moderation work and storage costs because users may upload videos.
• Viewers can often comment using existing Fediverse accounts, such as Mastodon, rather than creating accounts on the PeerTube instance.
• Federation settings determine whether other instances can follow and display the instance’s videos. Federation can extend a video’s reach, but administrators should consider where videos may appear and explain federation to users.

Transcoding and resource use

• Uploaded videos are transcoded into different resolutions for playback. The selected formats and resolutions affect storage use; keeping multiple formats or adding more resolutions can increase it.
• The tutorial recommends considering HLS and choosing resolutions that fit the instance’s storage and bandwidth budget.
• Live streaming and PeerTube’s video studio require more server resources. They should not be enabled on low-spec plans that cannot support them.
• The video notes that transcoding is a substantial topic and directs viewers to a separate tutorial for more detail.

Plugins, themes, and customization

• Custom CSS or JavaScript can make small interface adjustments; larger changes are better handled with a theme.
• Plugins can add features such as upload guidance, a custom logo, live chat, or analytics. The presenter recommends favoring official or recommended plugins, since others may become outdated, break after upgrades, or cause instability.
• Themes carry similar compatibility risks. Check whether a theme’s source repository is available and maintained before installing it. An outdated or broken theme may be difficult to disable.

Guides and tutorial topics covered

1. Creating a non-root user and setting up its profile.
2. Understanding the relationship between PeerTube users and channels.
3. Configuring a homepage, banner, and landing page.
4. Choosing instance information and signup settings.
5. Managing federation and interacting through other Fediverse accounts.
6. Considering transcoding, storage, and live-streaming requirements.
7. Evaluating plugins and themes for compatibility and reliability.

Main speaker/source: A FediHost presenter, who refers to the demonstration instance as Consultatron.