A fork of the GNU Social/AP-compatible microblogging server
Clone or download
Pull request Compare This branch is 232 commits ahead, 53 commits behind tootsuite:master.
gled-rs implement lain's patch to expose max_toot_chars in the instance prope…
…rties ( allow apps that supports it to act nicely )
Latest commit 084cd44 Nov 8, 2018
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 implement lain's patch to expose max_toot_chars in the instance prope… Nov 8, 2018
bin Upgrade Babel to version 7.0.0 (tootsuite#5925) Sep 14, 2018
config merge v2.6.0 Oct 30, 2018
db merge v2.6.0 Oct 30, 2018
dist Add nginx and systemd templates (tootsuite#8770) Sep 24, 2018
docs v2.6.0rc1 merged Oct 24, 2018
lib merge v2.6.1 Oct 31, 2018
log Initial commit Feb 20, 2016
nanobox [Nanobox] Tuning Update (tootsuite#6660) Mar 6, 2018
public merge v2.4.3 Jul 11, 2018
spec merge v2.6.1 Oct 31, 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 implement lain's patch to expose max_toot_chars in the instance prope… Nov 8, 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
AUTHORS.md Update AUTHORS.md (tootsuite#9141) Oct 29, 2018
Aptfile Adjust Aptfile for Heroku-18 stack (tootsuite#8588) Sep 9, 2018
CHANGELOG.md Bump version to 2.6.1 (tootsuite#9172) Oct 31, 2018
CODE_OF_CONDUCT.md Add code of conduct from GitHub generator (tootsuite#5674) Nov 13, 2017
CONTRIBUTING.md Update CONTRIBUTING.md (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
FTS_NOES.md update FTS doc Mar 13, 2018
Gemfile merge v2.6.0 Oct 30, 2018
Gemfile.lock merge v2.6.0 Oct 30, 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
Procfile.dev Fix Procfile on OS X (tootsuite#6748) Mar 12, 2018
README.md v2.6.0rc1 merged Oct 24, 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
config.ru 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 Specify node version to not use node11 (tootsuite#9166) Oct 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 i18n: Update Polish translation (tootsuite#8901) Oct 6, 2018


What is Mastodo ?

This is Mastodo, a Mastodon's fork implementing useful features that will not be implemented upstream.

We tend to integrate all the upstream commits, but allow more features to be available for both admins and users, while pooling the effort of maintaining a fork between multiple instances.

The goal is to have a fork with on/off switches for features that are not available upstream, allowing the admin a lot of customization to suit better his community.

Patches implemented:

  • PIWIK integration ( allows to have some nice anonymous, self hosted and opensource analytics on the visitors ).
  • Full Text search for statuses ( upstream code only allow searching users and hashtags, or needs Elastic Search to allow searching your own statuses only ).
  • FTS for your home timeline ( not only your own toots, but also people you follow, WIP ).
  • 20 results instead of 5 per type of search.
  • The FAQ link on the homepage points to /about/more instead of the github repo.
  • 2048 character limit for posts instead of 500 ( TODO: implement that as a configuration instead of being hardcoded ).
  • 512 character limit instead of 160 for profile bio ( TODO: implement that as a configuration instead of being hardcoded ).
  • replies and reboosts are displayed in the timelines instead of being ignored.
  • CI to check every user facing function is behaving correctly.
  • A few other minor tweaks like full column display to fill bigger screen, multiples themes, and other improvements...
  • Oauth patch to allow authentication by either the local username or the email ( necessary for the XMPP integration ).
  • Trending tags that got removed from upstream is available
  • Moderation tools for trending tags has been added.
  • Quite a few other tweaks I can't recall...
  • Glitch-Soc and Vahnj's patches are merged in the glitch-vahnj branch for now, time to add the necessary on/off switches for all those features !

Policy on this fork:

  • Everyone willing to contribute can request R/W privileges on this repo ( via GitHub, or via Mastodon to @gled@mastodon.host or to @kemonine@mastodon.social ).
  • We want to provide a customisable mastodon instance for the admins, allowing them to choose the feature set they want, and a full featured instance for your users.
  • Pull Request welcomed and accepted, whatever your rationale ( if you code something though just for you, or a niche feature, please make it optional and we'll merge it ! )
  • We won't reject a feature or a modification because 'I dont like it', ever.


  • For admins that want to just integrate the patch for FTS ( to allow not using ES and save a bit of resources ): Check the unmaintained FTS_NOES.md file !
  • If you are wondering why such a fork exists, take a look at the different topics about features on https://discourse.joinmastodon.org or check the upstream repository issue lists and the replies. Not every feature will make it upstream, so to make sure our users would get what they wanted, fork was the easiest way to avoid drama. We still merge upstream at each tag, and are grateful for their work.

Original full README is available on the upstream repository, extract below:



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 CONTRIBUTING.md

IRC channel: #mastodon on irc.freenode.net


Copyright (C) 2016-2018 Eugen Rochko & other Mastodon contributors (see AUTHORS.md)

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 https://www.gnu.org/licenses/.