software/Mastodon/admin: Difference between revisions

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
← Older edit
Woozle (talk | contribs)
Bureaucrats, Interface administrators, interwiki, Administrators, trusted
20,100 edits
VisualWikitext
Sidekiq
m Woozle moved page Mastodon/admin to software/Mastodon/admin: disambiguate from band (eventually)
 
(16 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|dethrone}}: remove admin privileges
* {{l/sub|mastodon-sidekiq.service}}: configuration file
* {{l/sub|mastodon-sidekiq.service}}: configuration file
* {{l/sub|Sidekiq}}: job manager
* {{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===
* '''2022-11-24''' [https://gianarb.it/blog/from-ubuntu-to-nixos-history-of-a-mastodon-migration From Ubuntu to NixOS the story of a mastodon migration]
* [https://github.com/staticsafe/mastodon-documentation/blob/master/Running-Mastodon/Production-Guide.md Mastodon Production Guide]: a walk through of the setup process
* [https://github.com/staticsafe/mastodon-documentation/blob/master/Running-Mastodon/Production-Guide.md Mastodon Production Guide]: a walk through of the setup process
** [https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Alternatives.md Alternative Server Components]: using nonstandard services (e.g. Apache instead of nginx)
** [https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Alternatives.md Alternative Server Components]: using nonstandard services (e.g. Apache instead of nginx)
Line 13: Line 30:
** [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://docs.joinmastodon.org/admin/ Administration guide]
** [https://docs.joinmastodon.org/admin/scaling/ Scaling up your server]: 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
===genearal===
** [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."
* '''2022-11-17''' [https://diskseven.com/blog/tootorial-toot-locale/ Tootelage: Modifying Mastodon to revert the ill-advised "Publish" button back to its eternally-loved "Toot"] ([https://social.diskseven.com/@Jo/109367415527122810 via])
===discussion===
===discussion===
* [https://discourse.joinmastodon.org/ Mastodon Meta Discussion Board] (using Discourse)
* [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

Latest revision as of 19:12, 12 March 2025

<hide> 

 page status::seed

</hide>

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

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

Retrieved from "https://htyp.org/mw/index.php?title=software/Mastodon/admin&oldid=29160"