Skip to content

Mastodon App


Mastodon is an open source decentralized social network - by the people for the people. Join the federation and take back control of your social media!


To make a user an administrator, use the Web Terminal and run the following command:

    bin/tootctl accounts modify <username> --role admin

Adding users

When used with Cloudron authentication, simply add new users to the Cloudron dashboard.

Without Cloudron authentication, new users can be added using the CLI:

    bin/tootctl accounts create testusername


Registration is closed by default. To enable, login to Mastodon as an admin and change the "Registration mode" under Administration -> Site Settings.

Federation Domain

Cloudron will setup Mastodon accounts to be of the form when you install Mastodon at We recommend using social as the subdomain for mastodon installations since it's easy to remember and type.

Mastodon has a way to create accounts as even when installed at The setup for this is complicated and in most cases unnecessary. Mastodon account names are not intended to be remembered like usernames (it's not like email where you can start following another account). Instead, users usually visit a website and click the 'Follow' button.

That said, you can change the account domain name by using the File Manager and changing LOCAL_DOMAIN in /app/data/env.production.

After that, you have to configure LOCAL_DOMAIN's web server to serve up .well-known/host-meta query.

LOCAL_DOMAIN is an app on Cloudron

If LOCAL_DOMAIN is an app on Cloudron, you can use Cloudron's Well Known URI support. Just add this file to /home/yellowtent/boxdata/well-known/

<?xml version="1.0" encoding="UTF-8"?>
<XRD xmlns="">
  <Link rel="lrdd" type="application/xrd+xml" template="{uri}"/>

LOCAL_DOMAIN is not an app on Cloudron

If the LOCAL_DOMAIN is NOT hosted on Cloudron, here are some hints:

  • For WordPress, you can setup a redirect using Redirection plugin
  • For Ghost,you can add a redirects.json
  • For Surfer, simply upload the XML above into .well-known/host-meta.
  • For anything else, setup nginx config as follows:
location = /.well-known/host-meta {
       return 301$request_uri;

Following users

To follow external users, visit their mastodon account and click on 'Follow'. This will popup a window asking your mastodon identity (which will be username@LOCAL_DOMAIN).

If you have an existing account on another server, you can bring those connections with you to your own server. For this, go to Settings -> Data Export and download your following list as a CSV file, and finally on your own server, you go to Settings -> Import and upload that file.