Your self-hosted, globally interconnected microblogging community
Clone or download
Pull request Compare This branch is 39 commits ahead, 143 commits behind tootsuite:master.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Update i18n-tasks and change CircleCI command (tootsuite#9104) Oct 28, 2018
.github Fix feature request issue template Oct 16, 2018
app Handle cases where user is nil in add_to_home and add_to_list Dec 3, 2018
bin Upgrade Babel to version 7.0.0 (tootsuite#5925) Sep 14, 2018
config Add setting to not aggregate reblogs Dec 3, 2018
db Remove progress estimate from MigrateAccountConversations (tootsuite#… Oct 30, 2018
dist Add nginx and systemd templates (tootsuite#8770) Sep 24, 2018
lib Bump version to 2.6.5 Dec 2, 2018
log Initial commit Feb 20, 2016
nanobox Update Nginx config for Nanobox apps (tootsuite#9310) Nov 23, 2018
public update twemojie to v2 (tootsuite#7911) Jul 5, 2018
spec Allow hyphens in the middle of remote user names (tootsuite#9345) Nov 30, 2018
streaming Fix crash when using UNIX socket (tootsuite#9036) Oct 21, 2018
vendor/assets Initial commit Feb 20, 2016
.buildpacks Add ffmpeg buildpack for scalingo (tootsuite#8500) Aug 28, 2018
.codeclimate.yml fix RuboCop error (tootsuite#7442) Jun 4, 2018
.dockerignore Add .bundle to .dockerignore (tootsuite#7895) Jun 26, 2018
.editorconfig Add final newline to locale files (tootsuite#2890) May 7, 2017
.env.nanobox Rename S3_CLOUDFRONT_HOST to S3_ALIAS_HOST. (tootsuite#8423) Aug 25, 2018
.env.production.sample Rename S3_CLOUDFRONT_HOST to S3_ALIAS_HOST. (tootsuite#8423) Aug 25, 2018
.env.test Do not test PAM authentication by default (tootsuite#9027) Oct 20, 2018
.env.vagrant update vagrant configs (tootsuite#8706) Sep 16, 2018
.eslintignore Dev Tooling fixes (eslint/editorconfig) (tootsuite#1398) Apr 10, 2017
.eslintrc.yml Update ESLint for Code Climate (tootsuite#7696) Jun 1, 2018
.foreman Replace sprockets/browserify with Webpack (tootsuite#2617) May 3, 2017
.gitattributes Add .gitattributes file to avoid unwanted CRLF (tootsuite#3954) Jun 26, 2017
.gitignore Ignore elasticsearch directory (tootsuite#7070) Apr 8, 2018
.haml-lint.yml Added haml-lint and fix warnings (tootsuite#2773) May 8, 2017
.nanoignore Remove Storybook (tootsuite#4397) Jul 27, 2017
.nvmrc Upgrade Node.js to v8.x on nvmrc (tootsuite#8023) Jul 15, 2018
.postcssrc.yml Add object-fit polyfill for Edge (tootsuite#4182) Jul 13, 2017
.profile Add ffmpeg and dependent packages as well as LD_LIBRARY_PATHs (tootsu… May 24, 2017
.rspec Adding a Mention model, test stubs Feb 24, 2016
.rubocop.yml Move more tasks to tootctl (tootsuite#8675) Sep 14, 2018
.ruby-version Use Ruby ==2.5.2== 2.5.3 (tootsuite#9003) Oct 18, 2018
.scss-lint.yml Enable CodeClimate SCSS Lint checks (tootsuite#2886) May 7, 2017
.slugignore Remove Storybook (tootsuite#4397) Jul 27, 2017
.yarnclean Reduce container size with clean yarn (tootsuite#3506) Sep 30, 2017 Update (tootsuite#9141) Oct 29, 2018
Aptfile Adjust Aptfile for Heroku-18 stack (tootsuite#8588) Sep 9, 2018 Bump version to 2.6.5 Dec 2, 2018 Add code of conduct from GitHub generator (tootsuite#5674) Nov 13, 2017 Update (tootsuite#9014) Oct 19, 2018
Capfile remove capistrano/faster_assets from Capfile (tootsuite#2737) May 3, 2017
Dockerfile Update Dockerfile (tootsuite#9026) Oct 23, 2018
Gemfile Preload common JSON-LD contexts (tootsuite#9412) Dec 2, 2018
Gemfile.lock Preload common JSON-LD contexts (tootsuite#9412) Dec 2, 2018
LICENSE Fix tootsuite#49 - License changed from GPL-2.0 to AGPL-3.0 Sep 21, 2016
Procfile More robust PuSH subscription refreshes (tootsuite#2799) May 5, 2017 Fix Procfile on OS X (tootsuite#6748) Mar 12, 2018 Improve README (tootsuite#9012) Oct 19, 2018
Rakefile Initial commit Feb 20, 2016
Vagrantfile update vagrant configs (tootsuite#8706) Sep 16, 2018
app.json Change logo URL for Heroku and Scalingo (tootsuite#4476) Aug 1, 2017
babel.config.js Upgrade Babel to version 7.0.0 (tootsuite#5925) Sep 14, 2018
boxfile.yml [Nanobox] Enable ElasticSearch support by default (tootsuite#6977) Mar 31, 2018 Fix rubocop issues, introduce usage of frozen literal to improve perf… Nov 15, 2016
docker-compose.yml Persist volumes by default in docker-compose (tootsuite#9055) Oct 22, 2018
jest.config.js Enable coverage for Jest (tootsuite#5442) Oct 18, 2017
package.json Remove npm-run-all dependency (tootsuite#9401) Nov 30, 2018
priv-config TOR federation (tootsuite#7875) Jun 26, 2018
scalingo.json Add ffmpeg buildpack for scalingo (tootsuite#8500) Aug 28, 2018
yarn.lock Remove npm-run-all dependency (tootsuite#9401) Nov 30, 2018


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