English

Français

English

Français

Appearance

Customize your instance ​

Install a theme ​

You can install themes created by the PeerTube community in the Left Menu -> Administration section -> Settings -> Plugins/Themes.

Then, you can set your default instance theme in the Left Menu -> Administration section -> Settings -> Configuration -> Basic.

Your users will be able to override this setting in their preference, so they can choose another theme among those you have installed.

Learn how to create a theme: https://docs.joinpeertube.org/contribute/plugins

Customize your instance CSS ​

If you just want to update some elements of your instance, you can also inject some CSS code configured in the Left Menu -> Administration section -> Settings -> Configuration -> Advanced.

It's easy to change the main PeerTube colors using CSS variables using:

css
body#custom-css {
  --primary: #E8252D;
}

See the theme documentation for an overview of the PeerTube variable system.

Install a plugin ​

Administrators can install plugins to change the behaviour of their PeerTube application. Plugins can inject CSS, change the UI and the server logic.

A plugin could for example:

  • Hide some buttons (counters, menu entries...)
  • Reject specific comments or videos (depending on many criterias)
  • Put videos in quarantine
  • Add client analytics (Matomo plugin, etc.)
  • Add a CAPTCHA in the registration form (see CAPTCHA plugins)
  • Block some IPs
  • Customize the player
  • Add auth methods to your PeerTube instance (LDAP, OpenId, etc.)
  • ...

You can install plugins created by the PeerTube community in the Left Menu -> Administration section -> Settings -> Plugins/Themes.

Learn how to create a plugin: https://docs.joinpeertube.org/contribute/plugins

Inject JavaScript in client ​

If you just want to update a particular client behaviour of your instance, you can also inject some JavaScript code configured in the Left Menu -> Administration section -> Settings -> Configuration -> Advanced.