This repository has been archived by the owner. It is now read-only.
Full documentation repository for Mastodon
Branch: master
Clone or download


Note: The documentation has moved to a different repository, where it is compiled to This repository is no longer updated.

Mastodon is a free, open-source social network server based on open web protocols like ActivityPub and OStatus. The social focus of the project is a viable decentralized alternative to commercial social media silos that returns the control of the content distribution channels to the people.


Using Mastodon

Using the API

Running Mastodon

In production

Please note: It is highly recommended to run a tagged release of Mastodon and not run off the current master branch.

The aforementioned guides presume using certain software, like Nginx. But using alternatives is possible: Alternative system configurations

In development

Contributing to Mastodon