trwnh/mastodon

Mastodon is a free, open-source social network platform that you can host yourself. Think of it as an alternative to Twitter or X, but instead of one company controlling everything, anyone can set up their own server. Users can post text, links, images, and short videos, and follow people both on their own server and on other servers around the world. What makes it different from a typical social network is federation. Each server operates independently, but they can all talk to each other. Someone on one server can follow and interact with someone on a completely different server, as long as both use the same underlying communication standard (called ActivityPub). This means the network is made up of many connected communities rather than one centralized platform. The feature set covers what you would expect from a modern social network. There are real-time timelines that update live as people post, support for media attachments like images and videos, and a set of safety tools including private posts, locked accounts, content filtering, muting, blocking, and a reporting system for moderation. It also supports third-party apps through an API, which has led to a variety of mobile and desktop clients built by the community. This would appeal to a few different groups. A community organizer who wants a private social space for their members could host a server and set their own rules. A company concerned about data ownership might run an internal microblogging tool. Or a group of friends could set up a small instance just for themselves. Essentially, anyone who wants the social media experience without relying on a big tech company could find this useful. On the technical side, the project is built with Ruby on Rails for the backend API and web pages, React for the dynamic interface, and Node.js for real-time streaming. It requires a PostgreSQL database and Redis, and the repository includes configuration options for deployment through Docker, Heroku, and other platforms. The README does not go into deep detail on setup beyond pointing to the official documentation, but there is a Vagrant configuration included for developers who want to get a local environment running quickly.