What is the Mastodon documentation site?

Updated

docs.joinmastodon.org is the official documentation site for the Mastodon software. It is a reference site, not a Mastodon server: you cannot sign up, post, or follow anyone there. Use it when you want to understand how Mastodon works, how federation and ActivityPub fit together, or how to run and use a Mastodon server.

What the site covers

The documentation is organized around explaining Mastodon as software rather than promoting a particular server. Its opening section, "What is Mastodon?", walks through the core concepts:

  • Microblogging — publishing small updates to a stream on your profile, with optional media such as pictures, audio, video, or polls.
  • Federation — a form of decentralization where many independent services interoperate instead of one central service serving everyone.
  • ActivityPub — the standardized, open protocol Mastodon uses to implement federation.

The site places these in context with a comparison of network structures:

Structure Examples
Centralized Twitter, Facebook, Instagram
Federated Email, XMPP, phone networks, physical mail
Distributed BitTorrent, IPFS, Scuttlebutt

The email analogy is the one the documentation leans on: just as you can send mail from Gmail to Outlook, Fastmail, or Protonmail, a Mastodon user can mention or message anyone on any participating website using their address.

Why the ActivityPub explanation matters

Mastodon is not the only software speaking ActivityPub. The documentation names several other implementations that can communicate with Mastodon servers:

  • Pleroma — a modular microblogging engine
  • Pixelfed — federated image sharing
  • Misskey — microblogging plus a customizable dashboard
  • PeerTube — video uploads to channels
  • Plume — longer-form articles

Together these form the fediverse, the set of websites that can communicate over ActivityPub and the web. The documentation notes that "follow me on Mastodon" is more common than "follow me on the fediverse," even though the latter is technically more accurate.

Practical implications it raises

Because Mastodon is software that can power any website, the documentation points out that service provider and policy choices matter — the server you join sets rules you are subject to. It also includes a "Choose your path" section, which separates readers who want to use Mastodon from those who want to run a server.

When to use this site

Reach for docs.joinmastodon.org when you need:

  • A definition of federation, ActivityPub, or the fediverse
  • Guidance on running or administering a Mastodon instance
  • An explanation of how Mastodon differs from centralized platforms

Skip it if you are looking for a server to join or an account to create — that happens on an individual Mastodon website, not on the documentation site.