Custom front end for Mastodon
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Eugen Rochko 6542c68a59 Add audio uploads
Fix #4827
5 years ago
.circleci Update i18n-tasks and change CircleCI command (#9104) 5 years ago
.github Fix feature request issue template 5 years ago
app Add audio uploads 5 years ago
bin Upgrade Babel to version 7.0.0 (#5925) 5 years ago
config Add setting to not aggregate reblogs (#9248) 5 years ago
db Add profile directory (#9427) 5 years ago
dist Add nginx and systemd templates (#8770) 5 years ago
lib Improve account suspension speed and completeness (#9290) 5 years ago
log Initial commit 7 years ago
nanobox Update Nginx config for Nanobox apps (#9310) 5 years ago
public update twemojie to v2 (#7911) 5 years ago
spec Add specs for Admin::InvitesController (#9471) 5 years ago
streaming Fix crash when using UNIX socket (#9036) 5 years ago
vendor/assets Initial commit 7 years ago
.buildpacks Add ffmpeg buildpack for scalingo (#8500) 5 years ago
.codeclimate.yml fix RuboCop error (#7442) 5 years ago
.dockerignore Add .bundle to .dockerignore (#7895) 5 years ago
.editorconfig Add final newline to locale files (#2890) 6 years ago
.env.nanobox Rename S3_CLOUDFRONT_HOST to S3_ALIAS_HOST. (#8423) 5 years ago
.env.production.sample Rename S3_CLOUDFRONT_HOST to S3_ALIAS_HOST. (#8423) 5 years ago
.env.test Do not test PAM authentication by default (#9027) 5 years ago
.env.vagrant update vagrant configs (#8706) 5 years ago
.eslintignore Dev Tooling fixes (eslint/editorconfig) (#1398) 6 years ago
.eslintrc.yml Update ESLint for Code Climate (#7696) 5 years ago
.foreman Replace sprockets/browserify with Webpack (#2617) 6 years ago
.gitattributes Add .gitattributes file to avoid unwanted CRLF (#3954) 6 years ago
.gitignore Ignore elasticsearch directory (#7070) 5 years ago
.haml-lint.yml Added haml-lint and fix warnings (#2773) 6 years ago
.nanoignore Remove Storybook (#4397) 6 years ago
.nvmrc Upgrade Node.js to v8.x on nvmrc (#8023) 5 years ago
.postcssrc.yml Add object-fit polyfill for Edge (#4182) 6 years ago
.profile Add ffmpeg and dependent packages as well as LD_LIBRARY_PATHs (#3276) 6 years ago
.rspec Adding a Mention model, test stubs 7 years ago
.rubocop.yml Move more tasks to tootctl (#8675) 5 years ago
.ruby-version Use Ruby ==2.5.2== 2.5.3 (#9003) 5 years ago
.scss-lint.yml Enable CodeClimate SCSS Lint checks (#2886) 6 years ago
.slugignore Remove Storybook (#4397) 6 years ago
.yarnclean Reduce container size with clean yarn (#3506) 6 years ago Update (#9141) 5 years ago
Aptfile Adjust Aptfile for Heroku-18 stack (#8588) 5 years ago Bump version to 2.6.5 (#9413) 5 years ago Add code of conduct from GitHub generator (#5674) 6 years ago Update (#9014) 5 years ago
Capfile remove capistrano/faster_assets from Capfile (#2737) 6 years ago
Dockerfile Update Dockerfile (#9026) 5 years ago
Gemfile Bump rails from to 5.2.2 (#9430) 5 years ago
Gemfile.lock Bump rubocop from 0.61.0 to 0.61.1 (#9451) 5 years ago
LICENSE Fix #49 - License changed from GPL-2.0 to AGPL-3.0 7 years ago
Procfile More robust PuSH subscription refreshes (#2799) 6 years ago Fix Procfile on OS X (#6748) 5 years ago Improve README (#9012) 5 years ago
Rakefile Initial commit 7 years ago
Vagrantfile update vagrant configs (#8706) 5 years ago
app.json Change logo URL for Heroku and Scalingo (#4476) 6 years ago
babel.config.js Upgrade Babel to version 7.0.0 (#5925) 5 years ago
boxfile.yml [Nanobox] Enable ElasticSearch support by default (#6977) 5 years ago Fix rubocop issues, introduce usage of frozen literal to improve performance 7 years ago
docker-compose.yml Persist volumes by default in docker-compose (#9055) 5 years ago
jest.config.js Enable coverage for Jest (#5442) 6 years ago
package.json Remove npm-run-all dependency (#9401) 5 years ago
priv-config TOR federation (#7875) 5 years ago
scalingo.json Add ffmpeg buildpack for scalingo (#8500) 5 years ago
yarn.lock Remove npm-run-all dependency (#9401) 5 years 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