Troubleshooting

I just installed/upgraded the plugin, but nothing happens

If you have just installed/upgraded the plugin, but nothing happens (no chat, no settings, buttons in the settings page does not work, …), just try to reload the page.

Diagnostic tool

If the chat does not work, there is a diagnostic tool in the plugin’s settings pages.

Open the plugin settings, and click on the “launch diagnostic” button.

If there is any error in the diagnostic page, you can search in this page for a solution, or refer to the Bug tracking documentation page if you can’t find any response.

Chat does not load

Internal API calls

In some case (like for some Docker Peertube installation), the diagnostic tools displays an error for the test called “API Prosody -> Peertube is KO”.

In such case, try changing the “API呼び出しのためのPeerTube URL” settings, by setting http://127.0.0.1:9000 (assuming 9000 is the port on which Peertube listen, ask your instance administrators if you don’t know).

Check the help for this settings for more information.

Websocket

If everything is fine in the diagnostic tools, but chat windows remains empty: it can be a Websocket issue. Since Peertube version 5.0.0, there are some additional configuration to do on the server side. Check with the instance administrators that they did not forgot to apply changes listed in the Peertube v5.0.0 release notes.

You can confirm that it is a Websocket issue by opening your browser console, and checking for error logs talking about failed Websocket connection.

If you can’t fix this immediatly, you can disable Websocket by unchecking “Websocketを無効にする” in the plugin setting page. In such case, you should also check “チャット情報を公開しない”, as chat federation won’t work without Websocket.