Mastodon

• Website
• Docs
• Github
• Support at Github discussions
• awesome-fediadmin A collection of awesome resources for running your own federated social media website.
• gotosocial A Mastodon server written in go

Install

Helm chart

The values for these secrets must be set:

helm template \
  --set mastodon.secrets.secret_key_base='foo' \
  --set mastodon.secrets.otp_secret='foo' \
  --set mastodon.secrets.vapid.private_key='foo' \
  --set mastodon.secrets.vapid.public_key='foo' \
  .

Setup

Reset admin passwort

See also tootctl docs

alias tootctl='kubectl -n mastodon exec -it deployment/mastodon-web -- tootctl'
tootctl accounts modify admin --reset-password

Manual Elasticsearch re-index

tootctl search deploy

or seperate INDEXes at once

tootctl search deploy --only tags

When this fails with You can't set the item's total value to less than the current progress. (ProgressBar::InvalidProgressError) this workaround worked at least

sed -E 's/indices.sum.+/2000/g' -i /opt/mastodon/lib/mastodon/search_cli.rb
tootctl search deploy

Blocklists

• Federation Safety Enhancement Project?

Issues

Full text search

From Search docs:

Mastodon’s full-text search allows logged-in users to find results from their own posts, their favourites, their bookmarks and their mentions. It deliberately does not allow searching for arbitrary strings in the entire database, in order to reduce the risk of abuse by people searching for controversial terms to find people to dogpile.

Related issues / PRs:

• Search doesn't find public posts, only you own

Tools

• Strubbl/mastodon-toots-exporter Exports toots of your Mastodon account
• madonctl Go-CLI client for the Mastodon social network API
• toot - Mastodon CLI & TUI
• Mastodeck
  • Tweetdeck alternative
  • Closed source SAAS

Server administration

Migrate/restore server

• How to fully re-install Mastodon and keep database
• Decommission server instance
  • Remove remote users/posts with tootctl, otherwise these will be cached on other servers as zombies

Resource Tuning

Sidekiq

• Optimizing Mastodon Performance with Sidekiq and Redis Enterprise

Monitoring

• FR: Prometheus exporter
  • It seems streaming API gots prometheus metrics

Metrics exporters

• Mastodon prometheus exporter FR

Standalone exporters

So far, there's no helm chart for most of these exporters, unless explicitly mentioned.

• marians/mastodon-metrics-exporter Metrics: Mastodon, Postgres, Redis, search
• systemli/prometheus-mastodon-exporter
  • Only few metrics: Domains, statuses, users, weekly_logins, weekly_registrations, weekly_statuses
• sidekiq-prometheus-exporter
  • Helm chart

Stale:

• dadall/mastodon_exporter
• b2d-prometheus/mastodon exporter

Exporters using statsd

• Mastodon - Part 3 - statsd and Prometheus
  • Matching Mastodon Stats Grafana dashboard
• Mastodon monitoring and metrics setup
  • Uses statsd-exporter (statsd_mapping)
• prometheus-statsd-exporter
  • helm chart