Skip to content
Your self-hosted, globally interconnected microblogging community
Ruby JavaScript CSS HTML Other
Branch: master
Clone or download


Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Update config.yml (#13379) Apr 4, 2020
.dependabot Increase dependabot dependencies scope from security-only. (#13400) Apr 6, 2020
.github Add config for issue template (#12306) Nov 13, 2019
app Fix trying to delete already deleted file when post-processing (#13406) Apr 6, 2020
bin Bump webpacker from 3.5.5 to 4.0.2 (#10277) Mar 15, 2019
config New Crowdin translations (#13317) Apr 5, 2020
db Fix PostgreSQL load when linking in announcements (#13250) Apr 5, 2020
dist Update nginx.conf (#13066) Mar 8, 2020
lib Fix regression in `tootctl media remove-orphans` (#13405) Apr 6, 2020
log Initial commit Feb 20, 2016
nanobox Resync Nanobox files with the 2.9.0 release (#11083) Jun 14, 2019
public Updated Twemoji to 12.1.3 (#12342) Nov 10, 2019
spec Add ability to filter audit log in admin UI (#13381) Apr 3, 2020
streaming minor server-sent events fixes (#12945) Jan 24, 2020
vendor Increase files checked by ESLint (#9705) Jan 4, 2019
.buildpacks Add ffmpeg buildpack for scalingo (#8500) Aug 28, 2018
.codeclimate.yml Update ESLint and RuboCop in Code Climate (#12534) Dec 2, 2019
.dockerignore Add .bundle to .dockerignore (#7895) Jun 26, 2018
.editorconfig Add final newline to locale files (#2890) May 7, 2017
.env.nanobox Fix sample SAML_ACS_URL, SAML_ISSUER (#12669) Dec 23, 2019
.env.production.sample Document AUTHORIZED_FETCH mode and WHITELIST_MODE (#12856) Jan 22, 2020
.env.test Bump webpacker from 4.0.7 to 4.2.0 (#12416) Nov 20, 2019
.env.vagrant fix vagrant connection error (#12180) Oct 24, 2019
.eslintignore Increase files checked by ESLint (#9705) Jan 4, 2019
.eslintrc.js Refactor icons in web UI to use Icon component (#9951) Jan 31, 2019
.foreman Replace sprockets/browserify with Webpack (#2617) May 3, 2017
.gitattributes Add .gitattributes file to avoid unwanted CRLF (#3954) Jun 26, 2017
.gitignore Use eslint cache (#12668) Dec 23, 2019
.haml-lint.yml Added haml-lint and fix warnings (#2773) May 8, 2017
.nanoignore Remove Storybook (#4397) Jul 27, 2017
.nvmrc Upgrade .nvmrc to Node.js 12 (#12906) Jan 21, 2020
.profile Add ffmpeg and dependent packages as well as LD_LIBRARY_PATHs (#3276) May 24, 2017
.rspec Adding a Mention model, test stubs Feb 24, 2016
.rubocop.yml Update ESLint and RuboCop in Code Climate (#12534) Dec 2, 2019
.ruby-version Update .ruby-version (#13395) Apr 5, 2020
.sass-lint.yml Fix sass-lint config (#10982) Jun 6, 2019
.slugignore Remove Storybook (#4397) Jul 27, 2017
.yarnclean Replace from scss-lint to sass-lint (#10958) Jun 4, 2019 Update (#12096) Oct 7, 2019
Aptfile Adjust Aptfile for Heroku-18 stack (#8588) Sep 9, 2018 Update (#13397) Apr 5, 2020 Add code of conduct from GitHub generator (#5674) Nov 13, 2017 Edit (#12401) Nov 17, 2019
Capfile remove capistrano/faster_assets from Capfile (#2737) May 3, 2017
Dockerfile [Security] Update Dockerfile for Ruby 2.6.6 (#13393) Apr 5, 2020
Gemfile Bump rails from to and kind-of from 6.0.2 to 6.0.3 (#… Apr 4, 2020
Gemfile.lock Bump rails from to and kind-of from 6.0.2 to 6.0.3 (#… Apr 4, 2020
LICENSE Fix #49 - License changed from GPL-2.0 to AGPL-3.0 Sep 21, 2016
Procfile Bind servers to in Procfile (#11378) Jul 22, 2019 Fix Procfile on OS X (#6748) Mar 12, 2018 Decommission support for Ruby 2.4 (#13287) Mar 21, 2020
Rakefile Initial commit Feb 20, 2016
Vagrantfile Update Vagrant box to Bionic (#13384) Apr 4, 2020
app.json Remove deprecated config from Heroku and Scalingo (#11925) Sep 23, 2019
babel.config.js Remove unnecessary dependencies (#12533) Dec 2, 2019
boxfile.yml Correct the Nanobox deploy hooks for order and context (#12663) Dec 22, 2019 Fix rubocop issues, introduce usage of frozen literal to improve perf… Nov 15, 2016
crowdin.yml Update Crowdin configuration file Sep 14, 2019
docker-compose.yml Add healthcheck endpoint for web (#11770) Sep 7, 2019
package.json Bump rails from to and kind-of from 6.0.2 to 6.0.3 (#… Apr 4, 2020
postcss.config.js Increase files checked by ESLint (#9705) Jan 4, 2019
priv-config TOR federation (#7875) Jun 26, 2018
scalingo.json Remove deprecated config from Heroku and Scalingo (#11925) Sep 23, 2019
yarn.lock Bump rails from to and kind-of from 6.0.2 to 6.0.3 (#… Apr 4, 2020


GitHub release Build Status Code Climate Crowdin Docker Pulls

Mastodon is a free, open-source social network server based on ActivityPub where users can follow friends and discover new ones. On Mastodon, users can publish anything they want: links, pictures, text, video. All Mastodon servers are interoperable as a federated network (users on one server can seamlessly communicate with users from another one, including non-Mastodon software that 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 choices!


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 4+
  • Ruby 2.5+
  • Node.js 10.13+

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 (C) 2016-2020 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

You can’t perform that action at this time.