Difference between revisions of "Mastodon/admin"

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
Jump to navigation Jump to search
(more links, in sections now)
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{seed}}
 
{{seed}}
 
==Pages==
 
==Pages==
 +
* {{l/sub|backups}}: how to backup and restore an instance
 
* {{l/sub|character limit}}: notes on how to modify the maximum length of a toot
 
* {{l/sub|character limit}}: notes on how to modify the maximum length of a toot
 +
* {{l/sub|debugging}}
 +
* {{l/sub|dethrone}}: remove admin privileges
 +
* {{l/sub|mastodon-sidekiq.service}}: configuration file
 +
* {{l/sub|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: <code>[[systemctl]] {{arg|start/stop/restart}} mastodon-*.service</code>
 +
 +
Recently, we have found that <code>start</code> often does not work with the <code>*</code> wildcard, and the processes must be started individually:
 +
* <code>systemctl start mastodon-sidekiq.service</code>
 +
* <code>systemctl start mastodon-streaming.service</code>
 +
* <code>systemctl start mastodon-web.service</code>
 +
 
==Links==
 
==Links==
 
===installing===
 
===installing===
Line 10: Line 29:
 
** [https://ashfurrow.com/blog/moving-mastodon-to-digital-ocean/ Moving Mastodon to Digital Ocean] ...but apparently is a really easy way to do it
 
** [https://ashfurrow.com/blog/moving-mastodon-to-digital-ocean/ Moving Mastodon to Digital Ocean] ...but apparently is a really easy way to do it
 
* [https://github.com/staticsafe/mastible Mastible]: an {{l/sw/ansible}} playbook to install Mastodon
 
* [https://github.com/staticsafe/mastible Mastible]: an {{l/sw/ansible}} playbook to install Mastodon
 +
* '''2018-01-18''' (update) [https://medium.com/blogging-of-2004-today/setting-up-your-own-mastodon-with-digital-ocean-and-docker-29e633d354f2 Setting up your own Mastodon, with Digital Ocean and Docker]
 +
===administering===
 +
* [https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Administration-guide.md Administration guide]
 +
** [https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Tuning.md Tuning Mastodon]: adjusting workers/processes and so on
 +
* [https://docs.joinmastodon.org/admin/optional/object-storage-proxy/ Proxying object storage through nginx]: how to keep media URLs consistent even when changing backends
 +
 
===upgrading===
 
===upgrading===
 
Upgrading an instance to a new version:
 
Upgrading an instance to a new version:
* [https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Updating-Mastodon-Guide.md official]
+
* <s>[https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Updating-Mastodon-Guide.md official]</s>
* [https://github.com/staticsafe/mastodon-documentation/blob/master/Running-Mastodon/Updating-Mastodon-Guide.md Updating Mastodon] ([https://mastodon.zombocloud.com/users/staticsafe/updates/4279 via author])
+
* [https://github.com/packetbiral/mastodon-documentation/blob/master/Running-Mastodon/Updating-Mastodon-Guide.md Updating Mastodon] - packetbiral's guide
===administration===
+
** [https://github.com/staticsafe/mastodon-documentation/blob/master/Running-Mastodon/Updating-Mastodon-Guide.md this] (<s>[https://mastodon.zombocloud.com/users/staticsafe/updates/4279 via author]</s>) 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===
 
* [https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Administration-guide.md official]
 
* [https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Administration-guide.md official]
 +
===tasks===
 +
* [https://gist.github.com/monsterpit-daggertooth/a1088ab959c71fc02f2baf824c6f4025 snippet-copy_emojos.rb] ([https://monsterpit.net/@daggertooth/99384806716881228 via]) "A Mastodon Rails console snippet to batch-copy Emoji from another domain."
 +
===discussion===
 +
* [https://discourse.joinmastodon.org/ Mastodon Meta Discussion Board] (using Discourse)
 +
===posts===
 +
* '''2017-04-12''' [https://medium.com/tootsuite/scaling-mastodon-1becde463090 Scaling Mastodon: What it takes to house 43,000 users] by Eugen Rochko

Revision as of 13:25, 22 May 2022

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

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

administering

upgrading

Upgrading an instance to a new version:

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

tasks

discussion

posts