Home > User guide


User guide

Fedilab is initially designed to use with Mastodon instances.

Fedilab also supports,

   Peertube accounts since the version 1.63.0 and
   Pleroma accounts since the version 1.70.0.

The login procedure is similar for all networks.


Login screen is what you see when you open Fedilab for the first time after the installation. This is what it looks like.

Basic login

Most of the time you will be able to login with this method. There are few things you need to enter to login to your account.

  1. Instance
    In here you have to enter the host name of your instance. For an example if you created your account on https://mastodon.social, You have to type just “mastodon.social”.
    The login button will only work if the address you entered is valid and your instance is up.

  2. Peertube checkbox

    • If you’re trying to login to a Peertube account, Check this box
    • If you’re trying to login to a Mastodon or Pleroma account, leave this Unchecked
  3. Email

    • If you’re going to login to a Mastodon account Enter the Email address you used to sign up for the account
    • If you’re going to login to a Peertube or a Pleroma account, enter the Username of your account
  4. Password
    Enter the password for your account

  5. Press the login button. If there any mistakes in the information you entered, This step won’t work. In that case check everything again.

Authorization based login

If you have setup Two-Step Authentication for your account or if you don’t want to enter your information in the app, you can use this method to login.

  1. When you proceed after typing the host name of your instance, You will see a text saying “Two-step authentication?” as below.

    To complete next steps, you can continue with Fedilab’s internal browser or you can use your web browser.

  2. Skip this step if you want use Fedilab’s internal browser.
    To use a separate web browser, click on the three-dot-menu on the top-right corner and check ‘Custom tabs’ option

  3. Click on “Two-step authentication?” and it will open your instance’s login page.

  4. Enter your username, password and login to your account.

  5. Now enter your two-factor code. If you don’t have two-factor authentication enabled for your account, you won’t see this step.

  6. Then press ‘AUTHORIZE’ button to give Fedilab access to your account.

  7. Now the login procedure is complete and you will be taken to your account!