mrkeyoor.com_
Sun 25 Oct 15:01 UTC
Self-Hostedevaluationupdated 23 Oct 2026

mastodon review

Mastodon is a social network server that lets your community exchange posts with people on other servers using ActivityPub. It supplies accounts, a web interface, chronological timelines, and moderation tools so an organization can host its own part of that network.

+27stars / 7d
Verdict

Our Mastodon run passed all 4,061 Vitest tests in 162 seconds, but the skipped build leaves full server setup unverified. Choose it for an ActivityPub community when you can operate its service stack and staff moderation. If that responsibility is the sticking point, start with managed hosting or an account on an existing server.

We ran it

Lab card: what happened when we ran mastodonScreenshot of mastodon (joinmastodon.org)
Install✓ · 33s1645 packages · 797 MB
Buildn/ano build script
Tests✓ · 162s4061 passed · 0 failed of 4061 (vitest)
Repo10122 files~312,459 lines of source · 88.5 MB · 22 CI workflows · Dockerfile · tests dir

Answers from our run

Does mastodon build from source?

Dependencies installed in 33 seconds (1645 packages), and the project has no separate build step. We cloned commit 0ff87ba into a clean Debian container with 3 CPUs and no project-specific setup.

Do mastodon's tests pass?

Yes. The project's own test command finished in 162 seconds and reported 4061 passed, 0 failed (vitest).

Who should not use mastodon?

Anyone seeking a single-process server: the README separates Rails, PostgreSQL, Redis and Sidekiq, and Node.js streaming.

What are the alternatives to mastodon?

Misskey, Pixelfed. Our Mastodon run passed all 4,061 Vitest tests in 162 seconds, but the skipped build leaves full server setup unverified.

SetupN/ANot assessed: installation was not reproduced in a supported environment.
Docs4/5On the stated documentation scale, detailed hosting and release instructions earn 4 because current-branch and stable-release runtime requirements need reconciliation.
CommunityN/AOctober pushes and issue activity show maintenance, but support response quality and user outcomes were not assessed.
MaturityN/AThe JavaScript suite passed, but production boot, Rails behavior, federation, and release upgrades were not assessed.

Discussed on

  1. hnMastodon: AGPLv3 FOSS social network server324 points
  2. hnMastodon: Add end-to-end encryption API303 points
  3. hnMastodon 3.0296 points
  4. hnMastodon 2.4.0294 points
  5. hnMastodon v4.0.0 Release Candidate145 points

Who it’s for

Organizations that want their own community rules while members follow accounts on other ActivityPub servers.
Administrators comfortable operating Rails, PostgreSQL, Redis, background workers, and a streaming service.
Developers building clients against Mastodon's OAuth2, REST, or streaming interfaces.

Who it’s NOT for

Anyone seeking a single-process server: the README separates Rails, PostgreSQL, Redis and Sidekiq, and Node.js streaming.
Communities without a moderator: the hosting guide explicitly warns that a public service needs moderation and community management.
Operators unable to arrange a domain and reliable email delivery: the hosting guide requires both for identity, confirmation links, and notifications.
Teams whose software policy excludes AGPLv3: that is the license stated in the README.

Setup reality

Our sandbox installed commit 0ff87ba in 33 seconds: 1,645 dependencies recorded, 797 MB on disk. Vitest passed in 162 seconds with 4,061 passed and 0 failed out of 4,061. No build script or target was found, so the build was skipped. This measures the JavaScript path, not a complete Mastodon deployment.

A working server needs Rails, PostgreSQL, Redis and Sidekiq, and Node.js streaming. The hosting guide calls for a domain, an always-connected server, and email delivery. Container deployment configurations are included, but you still need to configure database access, the domain, and your chosen email service.

Use requirements for the revision you deploy: the current README lists Ruby 4.0 and Node.js 24+, while v4.7.3 lists Ruby 3.3+ and Node 22+. Our recorded image label lab-node:22 does not prove the sandbox's actual runtime or operating-system version.

A federated community still needs someone to run it

Mastodon lets people on your server follow and exchange posts with people on other ActivityPub servers. That's the useful bargain for an organization hosting its own community: you choose local rules while members keep connections beyond your website. The README describes chronological timelines, media attachments, and a web interface, so you aren't assembling the basic social experience yourself.

The decision gets harder when you become responsible for the people using it. Mastodon's own hosting guide warns that public service brings moderation and community management work. An invite-only community can be a sensible use, and the guide explicitly allows restricted registration. Either way, decide who handles reports before you invite people. A reporting interface gives that person somewhere to work.

What happened when we ran it

Our sandbox installed Mastodon commit 0ff87ba in 33 seconds, recorded 1,645 dependencies, and used 797 MB on disk. The October 16, 2026 run used a recorded configuration of 3 CPUs and 8 GB of RAM with image label lab-node:22. That label does not establish the actual runtime or operating-system version. Those would require the raw toolchain logs.

Vitest completed in 162 seconds: 4,061 passed, 0 failed out of 4,061. The harness found no build script or target and skipped the build step. A skipped build is still unverified. These are JavaScript-path results from the measured checkout, with no evidence here of a complete production deployment or a passing Rails suite.

The checkout contained 10,122 files, about 312,459 source lines, and occupied 88.5 MB. Our scan found 22 CI workflow files, a Dockerfile, a compose file, a tests directory, and monorepo workspaces. The installed footprint describes the measured dependency step. It cannot size a server's database or uploaded media, and the passing suite doesn't establish federation behavior under real traffic.

Rails, Redis and PostgreSQL remain outside a Yarn result

The README assigns web pages and REST endpoints to Ruby on Rails, storage to PostgreSQL, caching and queued work to Redis and Sidekiq, and streaming to Node.js. React and Redux handle the interactive interface. Someone comfortable contributing to the client may still need help operating the rest. Our successful dependency step gives that contributor useful evidence without answering whether their eventual server is ready.

The README includes Docker and compose deployment configurations, plus a link to standalone installation guidance. Containers are a useful packaging choice for that service stack. They don't decide how you will recover PostgreSQL data or investigate queued work in Sidekiq. The release notes explicitly ask administrators to back up the database before upgrading. Rehearse that recovery on the deployment you intend to keep.

The hosting guide also calls for a domain, an always-connected server, and email delivery for confirmation links and notifications. Optional object storage moves uploaded files away from the server's local disk. Budget those services separately. Keeping accounts accessible depends on more than whether the web page loads after an update.

The current README and v4.7.3 require different runtimes

The live README lists Ruby 4.0 and Node.js 24+, while the v4.7.3 release notes list Ruby 3.3 or newer and Node 22 or newer. Both name PostgreSQL 14+ and Redis 7.0+. This is a practical documentation trap: the development branch and the stable release do not describe the same requirements. Follow the requirements attached to your chosen code revision.

Release v4.7.3 was published on October 1, 2026. Its upgrade notes call for a database backup and warn that skipping releases can mean extra migration steps. That is enough reason to read the intervening notes before changing versions. Our October 16 commit run does not independently validate this release's upgrade path, even though both belong to the same project.

Moderation controls are a reason to choose Mastodon

Mastodon's README names locked accounts, phrase filtering, muting, blocking, and a reporting and moderation system. These are useful starting points for a community that wants its rules enforced locally. The work includes deciding which reports deserve action and how members can appeal. If nobody owns those decisions, postponing your own server is the sensible choice.

The README also documents OAuth2 plus REST and streaming APIs. That makes Mastodon relevant to teams building clients or integrations, not just people who like its web interface. Choose it when those interfaces and federation match the product you need. We have no request-latency or capacity measurements to tell you how much infrastructure that product will require.

October repository activity supports a trial, not a support promise

GitHub recorded a push on October 23, 2026. The October 1 release notes also link fixes for registration errors and account-deletion behavior to their issue and pull-request discussions. Those dated changes support calling development active. It doesn't measure response time for your bug. The combined open count includes pull requests, and neither that queue nor the star count is a reliability result.

Misskey is another federated social platform worth comparing if you are choosing a community's software. Pixelfed focuses on photo sharing. Pick Pixelfed when photography is the main activity; compare Misskey directly when another general social platform might suit your members. Neither received a sandbox comparison here.

Our documentation rating uses this scale: 1 means essential instructions are absent, 2 means major gaps, 3 means a usable route with omissions, 4 means detailed guidance with a caveat, and 5 means no material documentation gap found in the inspected route. Mastodon earns 4 because its hosting and release guidance is detailed, but readers must reconcile branch and release requirements. Setup, support quality, and production reliability remain unassessed. Start with a closed trial and verify email, a remote follow, and recovery before accepting public sign-ups.

Alternatives

ProjectWhat it isPick it when
MisskeyAnother open-source federated social platform.pick this instead when a direct comparison shows its community experience suits your members better; we did not compare it in the sandbox.
PixelfedA social platform focused on photo sharing across the fediverse.pick this instead when photography is the main activity your community wants to share.

Sources

  1. Mastodon README
  2. Running your own Mastodon server
  3. Mastodon v4.7.3 release notes
  4. Misskey README
  5. Pixelfed README
  6. Mastodon public repository metadata

More self-hosted reviews

umami · mathua · redlib · logto · bloom · Mailu · the whole board →