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.
Yamagishi Kazutoshi 1486fd64cc Move files for GitHub to .github directory (#5989) 6 years ago
.github Move files for GitHub to .github directory (#5989) 6 years ago
app Change account_id non-nullable in lists (#5979) 6 years ago
bin Update dependencies for Ruby (2017-10-30) (#5566) 6 years ago
config Improve public status page title (#5985) 6 years ago
db Change account_id non-nullable in lists (#5979) 6 years ago
docs Fix redirect link on (#1595) 7 years ago
lib Bump version to 2.1.0rc3 6 years ago
log Initial commit 8 years ago
nanobox [Nanobox] Apply Release Notes Changes (#5670) 6 years ago
public Add artist, title, and date metadata to boop.{mp3,ogg} (#5531) 6 years ago
spec Fix #5953 - Add GET /api/v1/accounts/:id/lists (#5983) 6 years ago
streaming Make it possible to bind streming service to (#5744) 6 years ago
vendor/assets Initial commit 8 years ago
.babelrc 🎄🔨 Force tree shake emojione (#4202) 7 years ago
.buildpacks Add heroku APT buildpack for scalingo. (#3051) 7 years ago
.codeclimate.yml Disable Code Climate maintainability checks (#5798) 6 years ago
.dockerignore Remove Storybook (#4397) 7 years ago
.editorconfig Add final newline to locale files (#2890) 7 years ago
.env.nanobox [Nanobox] Apply Release Notes Changes (#5670) 6 years ago
.env.production.sample Document REDIS_NAMESPACE (#5038) 6 years ago
.env.test Add recovery code support for two-factor auth (#1773) 7 years ago
.env.vagrant Add a default to .env.vagrant 7 years ago
.eslintignore Dev Tooling fixes (eslint/editorconfig) (#1398) 7 years ago
.eslintrc.yml Enable ESLint rules import/* (#5414) 6 years ago
.foreman Replace sprockets/browserify with Webpack (#2617) 7 years ago
.gitattributes Add .gitattributes file to avoid unwanted CRLF (#3954) 7 years ago
.gitignore Fix #5274 - Create symlink from public/500.html to public/assets/500.html (#5288) 6 years ago
.haml-lint.yml Added haml-lint and fix warnings (#2773) 7 years ago
.nanoignore Remove Storybook (#4397) 7 years ago
.nvmrc update Node to 6.x LTS (#1228) 7 years ago
.postcssrc.yml Add object-fit polyfill for Edge (#4182) 7 years ago
.profile Add ffmpeg and dependent packages as well as LD_LIBRARY_PATHs (#3276) 7 years ago
.rspec Adding a Mention model, test stubs 8 years ago
.rubocop.yml Add handling of Linked Data Signatures in payloads (#4687) 6 years ago
.ruby-version Bump ruby version to 2.4.2 (#4958) 6 years ago
.scss-lint.yml Enable CodeClimate SCSS Lint checks (#2886) 7 years ago
.slugignore Remove Storybook (#4397) 7 years ago
.travis.yml Yarn install from Debian package repository (#5899) 6 years ago
.yarnclean Reduce container size with clean yarn (#3506) 6 years ago
Aptfile Specify libicu explicitly in Aptfile (#4920) 6 years ago Add code of conduct from GitHub generator (#5674) 6 years ago README tidy up (#2026) 7 years ago
Capfile remove capistrano/faster_assets from Capfile (#2737) 7 years ago
Dockerfile Update Yarn to version 1.3.2 (#5900) 6 years ago
Gemfile Revert fog-aws (ref #5604) (#5934) 6 years ago
Gemfile.lock Revert fog-aws (ref #5604) (#5934) 6 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) 7 years ago Upgrade Webpacker to version 3.0.1 (#5122) 6 years ago fix Code Climate badge on (#5671) 6 years ago
Rakefile Initial commit 8 years ago
Vagrantfile Install libidn11-dev in Vagrant (#4238) 7 years ago
app.json Change logo URL for Heroku and Scalingo (#4476) 6 years ago
boxfile.yml [Nanobox] Apply Release Notes Changes (#5670) 6 years ago Fix rubocop issues, introduce usage of frozen literal to improve performance 7 years ago
docker-compose.yml Specify middleware versions in docker-compose.yml (#5247) 6 years ago Some Dockerfile improvements (#3182) 7 years ago
jest.config.js Enable coverage for Jest (#5442) 6 years ago
package.json Update dependencies for Node.js (2017-12-03) (#5876) 6 years ago
scalingo.json Change logo URL for Heroku and Scalingo (#4476) 6 years ago
yarn.lock Update dependencies for Node.js (2017-12-03) (#5876) 6 years ago


Build Status Code Climate

Mastodon is a free, open-source social network server based on open web protocols like ActivityPub and OStatus. The social focus of the project is a viable decentralized alternative to commercial social media silos that returns the control of the content distribution channels to the people. The technical focus of the project is a good user interface, a clean REST API for 3rd party apps and robust anti-abuse tools.

Click on the screenshot below to watch a demo of the UI:


Ruby on Rails is used for the back-end, while React.js and Redux are used for the dynamic front-end. A static front-end for public resources (profiles and statuses) is also provided.

If you would like, you can support the development of this project on Patreon. Alternatively, you can donate to this BTC address: 17j2g7vpgHhLuXhN4bueZFCvdxxieyRVWd



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

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

Real-time 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!

Federated thread resolving

If someone you follow replies to a user unknown to the server, the server fetches the full thread so you can view it without leaving the UI

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!

OAuth2 and a straightforward REST API

Mastodon acts as an OAuth2 provider so 3rd party apps can use the API

Fast response times

Mastodon tries to be as fast and responsive as possible, so all long-running tasks are delegated to background processing

Deployable via Docker

You don't need to mess with dependencies and configuration if you want to try Mastodon, if you have Docker and Docker Compose the deployment is extremely easy


Please follow the development guide from the documentation repository.


There are guides in the documentation repository for deploying on various platforms.


You can open issues for bugs you've found or features you think are missing. You can also submit pull requests to this repository. Here are the guidelines for code contributions

IRC channel: #mastodon on

Extra credits

The elephant friend illustrations are created by Dopatwo