An ActivityPub / OStatus - compatible social network platform, written in Ruby on Rails, react and NodeJS.
Elisa ad5d99ce3a
Fixed: JS compose limit bug
6 months ago
.circleci Update i18n-tasks and change CircleCI command (#9104) 1 month ago
.github Fix feature request issue template 2 months ago
app Fixed: JS compose limit bug 2 weeks ago
bin Upgrade Babel to version 7.0.0 (#5925) 3 months ago
config Preload common JSON-LD contexts (#9412) 2 weeks ago
db Remove progress estimate from MigrateAccountConversations (#9168) 1 month ago
dist Add nginx and systemd templates (#8770) 2 months ago
lib Bump version to 2.6.5 2 weeks ago
log Initial commit 2 years ago
nanobox Update Nginx config for Nanobox apps (#9310) 3 weeks ago
public update twemojie to v2 (#7911) 5 months ago
spec Allow hyphens in the middle of remote user names (#9345) 2 weeks ago
streaming Fix crash when using UNIX socket (#9036) 1 month ago
vendor/assets Initial commit 2 years ago
.buildpacks Add ffmpeg buildpack for scalingo (#8500) 3 months ago
.codeclimate.yml fix RuboCop error (#7442) 6 months ago
.dockerignore Add .bundle to .dockerignore (#7895) 5 months ago
.editorconfig Add final newline to locale files (#2890) 1 year ago
.env.nanobox Rename S3_CLOUDFRONT_HOST to S3_ALIAS_HOST. (#8423) 3 months ago
.env.production.sample Character limit: 500 −> 5000 2 weeks ago
.env.test Do not test PAM authentication by default (#9027) 1 month ago
.env.vagrant update vagrant configs (#8706) 3 months ago
.eslintignore Dev Tooling fixes (eslint/editorconfig) (#1398) 1 year ago
.eslintrc.yml Update ESLint for Code Climate (#7696) 6 months ago
.foreman Replace sprockets/browserify with Webpack (#2617) 1 year ago
.gitattributes Add .gitattributes file to avoid unwanted CRLF (#3954) 1 year ago
.gitignore Ignore elasticsearch directory (#7070) 8 months ago
.haml-lint.yml Added haml-lint and fix warnings (#2773) 1 year ago
.nanoignore Remove Storybook (#4397) 1 year ago
.nvmrc Upgrade Node.js to v8.x on nvmrc (#8023) 5 months ago
.postcssrc.yml Add object-fit polyfill for Edge (#4182) 1 year ago
.profile Add ffmpeg and dependent packages as well as LD_LIBRARY_PATHs (#3276) 1 year ago
.rspec Adding a Mention model, test stubs 2 years ago
.rubocop.yml Move more tasks to tootctl (#8675) 3 months ago
.ruby-version Use Ruby ==2.5.2== 2.5.3 (#9003) 2 months ago
.scss-lint.yml Enable CodeClimate SCSS Lint checks (#2886) 1 year ago
.slugignore Remove Storybook (#4397) 1 year ago
.yarnclean Reduce container size with clean yarn (#3506) 1 year ago Update (#9141) 1 month ago
Aptfile Adjust Aptfile for Heroku-18 stack (#8588) 3 months ago Bump version to 2.6.5 2 weeks ago Add code of conduct from GitHub generator (#5674) 1 year ago Update (#9014) 2 months ago
Capfile remove capistrano/faster_assets from Capfile (#2737) 1 year ago
Dockerfile Update Dockerfile (#9026) 1 month ago
Gemfile Preload common JSON-LD contexts (#9412) 2 weeks ago
Gemfile.lock Preload common JSON-LD contexts (#9412) 2 weeks ago
LICENSE Fix #49 - License changed from GPL-2.0 to AGPL-3.0 2 years ago
Procfile More robust PuSH subscription refreshes (#2799) 1 year ago Fix Procfile on OS X (#6748) 9 months ago Improve README (#9012) 2 months ago
Rakefile Initial commit 2 years ago
Vagrantfile update vagrant configs (#8706) 3 months ago
app.json Change logo URL for Heroku and Scalingo (#4476) 1 year ago
babel.config.js Upgrade Babel to version 7.0.0 (#5925) 3 months ago
boxfile.yml [Nanobox] Enable ElasticSearch support by default (#6977) 8 months ago Fix rubocop issues, introduce usage of frozen literal to improve performance 2 years ago
docker-compose.yml Persist volumes by default in docker-compose (#9055) 1 month ago
jest.config.js Enable coverage for Jest (#5442) 1 year ago
package.json Remove npm-run-all dependency (#9401) 2 weeks ago
priv-config TOR federation (#7875) 5 months ago
scalingo.json Add ffmpeg buildpack for scalingo (#8500) 3 months ago
yarn.lock Remove npm-run-all dependency (#9401) 2 weeks ago


GitHub release Build Status Code Climate Translation status Docker Pulls

Mastodon is a free, open-source social network server based on ActivityPub. Follow friends and discover new ones. Publish anything you want: links, pictures, text, video. All servers of Mastodon are interoperable as a federated network, i.e. users on one server can seamlessly communicate with users from another one. This includes non-Mastodon software that also implements ActivityPub!

Click below to learn more in a video:




No vendor lock-in: Fully interoperable with any conforming platform

It doesn't have to be Mastodon, whatever implements ActivityPub is part of the social network! Learn more

Real-time, chronological timeline updates

See the updates of people you're following appear in real-time in the UI via WebSockets. There's a firehose view as well!

Media attachments like images and short videos

Upload and view images and WebM/MP4 videos attached to the updates. Videos with no audio track are treated like GIFs; normal videos are looped - like vines!

Safety and moderation tools

Private posts, locked accounts, phrase filtering, muting, blocking and all sorts of other features, along with a reporting and moderation system. Learn more

OAuth2 and a straightforward REST API

Mastodon acts as an OAuth2 provider so 3rd party apps can use the REST and Streaming APIs, resulting in a rich app ecosystem with a lot of choice!


Tech stack:

  • Ruby on Rails powers the REST API and other web pages
  • React.js and Redux are used for the dynamic parts of the interface
  • Node.js powers the streaming API


  • PostgreSQL 9.5+
  • Redis
  • Ruby 2.4+
  • Node.js 8+

The repository includes deployment configurations for Docker and docker-compose, but also a few specific platforms like Heroku, Scalingo, and Nanobox. The stand-alone installation guide is available in the documentation.

A Vagrant configuration is included for development purposes.


Mastodon is free, open source software licensed under AGPLv3.

You can open issues for bugs you've found or features you think are missing. You can also submit pull requests to this repository, or submit translations using Weblate. To get started, take a look at

IRC channel: #mastodon on


Copyright (C) 2016-2018 Eugen Rochko & other Mastodon contributors (see

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see