Mastodon/admin

This page is a seed article. You can help HTYP water it: make a request to expand a given page and/or donate to help give us more writing-hours!

Pages

• backups: how to backup and restore an instance
• character limit: notes on how to modify the maximum length of a toot
• debugging
• dethrone: remove admin privileges
• mastodon-sidekiq.service: configuration file
• Sidekiq: job manager

How To

Restarting Mastodon

The Mastodon server consists of a standard web server which proxies certain requests through to each of three systemd processes:

• mastodon-sidekiq.service
• mastodon-streaming.service
• mastodon-web.service

In some environments, these may be started, stopped, or restarted with a single command: systemctl <start/stop/restart> mastodon-*.service

Recently, we have found that start often does not work with the * wildcard, and the processes must be started individually:

• systemctl start mastodon-sidekiq.service
• systemctl start mastodon-streaming.service
• systemctl start mastodon-web.service

Links

installing

• Mastodon Production Guide: a walk through of the setup process
  • Alternative Server Components: using nonstandard services (e.g. Apache instead of nginx)
• How to install a Mastodon instance on Ubuntu 16.04 LTS
• Deploying Mastodon on Digital Ocean: uses Docker
  • Moving Mastodon to Digital Ocean ...but apparently is a really easy way to do it
• Mastible: an Ansible playbook to install Mastodon
• 2018-01-18 (update) Setting up your own Mastodon, with Digital Ocean and Docker

administering

• Administration guide
  • Scaling up your server: adjusting workers/processes and so on
  • Proxying object storage through nginx: how to keep media URLs consistent even when changing backends

upgrading

Upgrading an instance to a new version:

• official
• Updating Mastodon - packetbiral's guide
  • this (via author) now redirects to the above

database issues

To repair a corrupted database (e.g. if you get "422 Duplicate Record" errors): https://docs.joinmastodon.org/admin/troubleshooting/index-corruption/

general

• official

tasks

• snippet-copy_emojos.rb (via) "A Mastodon Rails console snippet to batch-copy Emoji from another domain."
• 2022-11-17 Tootelage: Modifying Mastodon to revert the ill-advised "Publish" button back to its eternally-loved "Toot" (via)

discussion

• Mastodon Meta Discussion Board (using Discourse)

posts

• 2017-04-12 Scaling Mastodon: What it takes to house 43,000 users by Eugen Rochko