Go to file
Ben Lubar 9b475a4838 Add healthcheck commands to docker-compose.yml (#9143)
This will allow Docker to be automatically check the health of services.

Docker won't do anything other than showing the state in the output of
"docker-compose ps" by default, but some management tools may watch for
container health events.

Here's what my local instance looks like right now:

          Name                        Command                  State                     Ports
-------------------------------------------------------------------------------------------------------------
mastodon_db_1              docker-entrypoint.sh postgres    Up (healthy)
mastodon_es_1              /usr/local/bin/docker-entr ...   Up (healthy)
mastodon_redis_1           docker-entrypoint.sh redis ...   Up (healthy)
mastodon_redis_cache_1     docker-entrypoint.sh redis ...   Up (healthy)
mastodon_sidekiq_1         /sbin/tini -- bundle exec  ...   Up             3000/tcp, 4000/tcp
mastodon_streaming_1       /sbin/tini -- yarn start         Up (healthy)   3000/tcp, 127.0.0.1:4000->4000/tcp
mastodon_web_1             /sbin/tini -- bash -c rm - ...   Up (healthy)   127.0.0.1:3000->3000/tcp, 4000/tcp
2018-12-29 00:43:41 +01:00
.circleci Update i18n-tasks and change CircleCI command (#9104) 2018-10-28 07:15:20 +01:00
.github Fix feature request issue template 2018-10-16 03:02:01 +02:00
app Add pending specs for StatusLengthValidator (#9647) 2018-12-28 08:18:47 +01:00
bin Upgrade Babel to version 7.0.0 (#5925) 2018-09-14 17:59:48 +02:00
config Improve admin UI for account view (#9643) 2018-12-28 03:38:41 +01:00
db Add REST API for creating an account (#9572) 2018-12-24 19:12:38 +01:00
dist Add nginx and systemd templates (#8770) 2018-09-24 16:46:05 +02:00
lib Add REST API for creating an account (#9572) 2018-12-24 19:12:38 +01:00
log
nanobox Update Nginx config for Nanobox apps (#9310) 2018-11-20 22:24:35 +01:00
public
spec Add specs for StatusPinValidator (#9648) 2018-12-28 18:09:32 +09:00
streaming Fix crash when using UNIX socket (#9036) 2018-10-21 16:41:33 +02:00
vendor/assets
.buildpacks
.codeclimate.yml
.dockerignore
.editorconfig
.env.nanobox
.env.production.sample
.env.test Do not test PAM authentication by default (#9027) 2018-10-20 07:32:26 +02:00
.env.vagrant update vagrant configs (#8706) 2018-09-16 14:49:15 -04:00
.eslintignore
.eslintrc.yml
.foreman
.gitattributes
.gitignore
.haml-lint.yml
.nanoignore
.nvmrc
.postcssrc.yml
.profile
.rspec
.rubocop.yml Move more tasks to tootctl (#8675) 2018-09-14 17:42:22 +02:00
.ruby-version Use Ruby ==2.5.2== 2.5.3 (#9003) 2018-10-18 22:32:47 +02:00
.scss-lint.yml
.slugignore
.yarnclean
AUTHORS.md Update AUTHORS.md (#9141) 2018-10-29 14:05:53 +01:00
Aptfile Adjust Aptfile for Heroku-18 stack (#8588) 2018-09-09 02:10:58 +02:00
CHANGELOG.md Bump version to 2.6.5 (#9413) 2018-12-02 17:41:38 +01:00
CODE_OF_CONDUCT.md
CONTRIBUTING.md Update CONTRIBUTING.md (#9014) 2018-10-19 16:41:25 +02:00
Capfile
Dockerfile Dockerfile: Nodejs 8.12 -> 8.14 (#9532) 2018-12-16 05:50:09 +01:00
Gemfile Bump webmock from 3.4.2 to 3.5.1 (#9641) 2018-12-27 12:23:27 +01:00
Gemfile.lock Bump webmock from 3.4.2 to 3.5.1 (#9641) 2018-12-27 12:23:27 +01:00
LICENSE
Procfile
Procfile.dev
README.md Improve README (#9012) 2018-10-19 18:49:35 +02:00
Rakefile
Vagrantfile update vagrant configs (#8706) 2018-09-16 14:49:15 -04:00
app.json
babel.config.js Upgrade Babel to version 7.0.0 (#5925) 2018-09-14 17:59:48 +02:00
boxfile.yml
config.ru
docker-compose.yml Add healthcheck commands to docker-compose.yml (#9143) 2018-12-29 00:43:41 +01:00
jest.config.js
package.json Remove npm-run-all dependency (#9401) 2018-11-30 19:16:32 +01:00
priv-config
scalingo.json
yarn.lock Remove npm-run-all dependency (#9401) 2018-11-30 19:16:32 +01:00

README.md

Mastodon

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:

Screenshot

Navigation

Features

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!

Deployment

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

Requirements:

  • 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.

Contributing

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

License

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/.