Skip to content

Mastodon App

Admin

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 --email=test@cloudron.io

Federation Domain

Cloudron will setup Mastodon accounts to be of the form username@social.example.org when you install Mastodon at social.example.org. 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 username@example.org even when installed at mastodon.example.org. 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 Web Terminal 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/example.org/host-meta:

<?xml version="1.0" encoding="UTF-8"?>
<XRD xmlns="http://docs.oasis-open.org/ns/xri/xrd-1.0">
  <Link rel="lrdd" type="application/xrd+xml" template="https://social.example.org/.well-known/webfinger?resource={uri}"/>
</XRD>

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 https://social.example.org$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.