Decentralized social network.


The minimum instance for Mastodon is currently small. The micro plan is no longer available for new instances.

Puma and Sidekiq threads are scaled with instance size. The current values are:



Initial setup#

After creating a new Mastodon instance, go to the Mastodon site and create a user account. Once you have an account, grant yourself the Owner role through the User role job. This will enable full access to Mastodon's administration user interface.

For a production instance, you should configure a custom domain before interacting with other servers.

Local domain#

Mastodon is configured with two domains:

  • Web domain: This is where the Mastodon website and API are served from
  • Local domain: This is the unique identifier of your server

Usually, both have the same value. It is however possible to run the webserver on a different domain entirely. For this to work, you must set up a redirect from your local to your web domain.

location /.well-known/webfinger {
  add_header Access-Control-Allow-Origin '*';
  return 301$request_uri;

Refer to the Mastodon documentation for more information.