You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Exagone313 878883ba05 Merge tag 'v2.8.0' 1 week ago
.circleci Fix CircleCI (#9695) 3 months ago
.github Fix feature request issue template 6 months ago
app Merge tag 'v2.8.0' 1 week ago
bin Bump webpacker from 3.5.5 to 4.0.2 (#10277) 1 month ago
config [i18n] Update for Occitan language (#10548) 1 week ago
db Add "why do you want to join" field to invite requests (#10524) 1 week ago
dist Cache error 410 responses in recommended nginx configuration (#10425) 2 weeks ago
lib Merge tag 'v2.8.0' 1 week ago
log Initial commit 3 years ago
nanobox Update Nginx config for Nanobox apps (#9310) 4 months ago
public Change error graphic to hover-to-play (#10055) 1 month ago
spec Fix Keybase verification using wrong domain for remote accounts (#10547) 1 week ago
streaming Merge tag 'v2.8.0' 1 week ago
vendor Increase files checked by ESLint (#9705) 3 months ago
.buildpacks Add ffmpeg buildpack for scalingo (#8500) 7 months ago
.codeclimate.yml Upgrade ESLint to v5.x (#9694) 3 months ago
.dockerignore Add .bundle to .dockerignore (#7895) 9 months ago
.editorconfig Dev Tooling fixes (eslint/editorconfig) (#1398) 2 years ago
.env.nanobox Rename S3_CLOUDFRONT_HOST to S3_ALIAS_HOST. (#8423) 7 months ago
.env.production.sample Rename S3_CLOUDFRONT_HOST to S3_ALIAS_HOST. (#8423) 7 months ago
.env.test Do not test PAM authentication by default (#9027) 6 months ago
.env.vagrant update vagrant configs (#8706) 7 months ago
.eslintignore Increase files checked by ESLint (#9705) 3 months ago
.eslintrc.js Refactor icons in web UI to use Icon component (#9951) 2 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) 1 year 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) 9 months ago
.profile Add ffmpeg and dependent packages as well as LD_LIBRARY_PATHs (#3276) 1 year ago
.rspec Adding a Mention model, test stubs 3 years ago
.rubocop.yml Add `tootctl self-destruct` (#10367) 2 weeks ago
.ruby-version Upgrade Ruby to 2.6.1 (#9956) 1 month 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 Bump version to 2.8.0rc1 (#10340) 2 weeks ago
Aptfile Adjust Aptfile for Heroku-18 stack (#8588) 7 months ago Bump version to 2.8.0 (#10550) 1 week ago Add code of conduct from GitHub generator (#5674) 1 year ago Add note that contributors may request reimbursement through OpenCollective (#9933) 2 months ago
Capfile remove capistrano/faster_assets from Capfile (#2737) 1 year ago
Dockerfile Re-organize Dockerfile to improve incremental builds. (#10212) 1 month ago
Gemfile Bump rubocop from 0.66.0 to 0.67.1 (#10475) 1 week ago
Gemfile.lock Bump hamlit-rails from 0.2.2 to 0.2.3 (#10522) 1 week 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) 1 year ago Bumps copyright year in to 2019 (#9939) 1 month ago
Rakefile Initial commit 3 years ago
Vagrantfile Add clearer error when/if gpg fails to install (#10228) 1 month ago
app.json Change logo URL for Heroku and Scalingo (#4476) 1 year ago
babel.config.js Weblate translations (2019-04-10) (#10545) 1 week ago
boxfile.yml [Nanobox] Enable ElasticSearch support by default (#6977) 1 year ago Fix rubocop issues, introduce usage of frozen literal to improve performance 2 years ago
docker-compose.yml Remove uneeded command and switch to images for TOR (#9438) 3 months ago
package.json Fix emoji-mart crashing web UI on search by reverting the upgrade to 2.10.0 (#10413) 2 weeks ago
postcss.config.js Increase files checked by ESLint (#9705) 3 months ago
priv-config TOR federation (#7875) 9 months ago
scalingo.json Add ffmpeg buildpack for scalingo (#8500) 7 months ago
yarn.lock Fix emoji-mart crashing web UI on search by reverting the upgrade to 2.10.0 (#10413) 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 If your contributions are accepted into Mastodon, you can request to be paid through our OpenCollective.

IRC channel: #mastodon on


Copyright © 2016-2019 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