mastodon/mastodon - Detailed Review#

1. Overview & GitHub Stats#

• URL: https://github.com/mastodon/mastodon
• Stars: 48891

2. Project Description#

Mastodon is an open-source, self-hosted microblogging platform that forms part of the decentralized Fediverse network. Unlike centralized social media platforms, Mastodon allows users to join or create independent communities (instances) that can interoperate with each other. It provides a Twitter-like experience with enhanced privacy controls, community moderation, and no algorithmic timeline manipulation.

3. What Software Does It Replace?#

Mastodon serves as a decentralized alternative to:

• Twitter/X
• Facebook (for microblogging aspects)
• Commercial microblogging platforms
• Centralized social networking services

4. Core Functionality#

• Decentralized Networking: Operates on ActivityPub protocol for federation
• Self-Hosting Capability: Complete control over your instance
• Community Moderation: Instance-level content policies and moderation tools
• Privacy Features: Content warnings, private posts, and limited visibility options
• No Algorithms: Chronological timeline without manipulation
• Multiple Media Support: Images, videos, audio, and polls
• Accessibility: WCAG 2.1 compliant interface
• API Support: REST API for developers

5. Pros and Cons#

Pros:

• Complete data ownership and privacy control
• Ad-free experience
• Customizable instance rules and policies
• Strong community moderation tools
• Interoperable with other Fediverse platforms
• Transparent, open-source development

Cons:

• Requires technical knowledge for self-hosting
• Smaller user base compared to mainstream platforms
• Instance maintenance responsibility
• Potential fragmentation across instances
• Learning curve for new users

6. Detailed Installation Guide (Self-host)#

1
sudo apt update && sudo apt upgrade -y

1
sudo apt install docker.io docker-compose
2
sudo systemctl enable --now docker

1
mkdir mastodon && cd mastodon

1
curl -L https://raw.githubusercontent.com/mastodon/mastodon/main/docker-compose.yml -O

1
cp .env.production.sample .env.production
2
# Edit the .env.production file with your domain and secrets
3
nano .env.production

1
docker-compose run --rm web bundle exec rake mastodon:webpush:generate_vapid_key
2
docker-compose run --rm web rake secret
3
# Add generated secrets to your .env file

1
docker-compose build
2
docker-compose up -d

1
docker-compose run --rm web rails db:migrate
2
docker-compose run --rm web rails assets:precompile

1
docker-compose run --rm web rails mastodon:setup

1
sudo apt install nginx
2
sudo nano /etc/nginx/sites-available/mastodon

1
server {
2
    listen 80;
3
    server_name your-domain.com;
4

5
    location / {
6
        proxy_pass http://localhost:3000;
7
        proxy_set_header Host $host;
8
        proxy_set_header X-Real-IP $remote_addr;
9
    }
10
}

1
sudo apt install certbot python3-certbot-nginx
2
sudo certbot --nginx -d your-domain.com

1
docker-compose restart
2
sudo systemctl restart nginx

1
# Update Mastodon
2
docker-compose pull
3
docker-compose build
4
docker-compose run --rm web rails db:migrate
5
docker-compose run --rm web rails assets:precompile
6
docker-compose restart
7

8
# Backup database
9
docker-compose exec db pg_dump -U postgres mastodon_production > backup.sql