From 0aa91430d9c40f47cd756552c19b9f87d00e3098 Mon Sep 17 00:00:00 2001 From: Claire Date: Thu, 6 Feb 2025 14:22:29 +0100 Subject: [PATCH] Update documentation for `tootctl self-destruct` Fixes #1593 --- content/en/admin/tootctl.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/content/en/admin/tootctl.md b/content/en/admin/tootctl.md index 67e0149f..69f8a8e5 100644 --- a/content/en/admin/tootctl.md +++ b/content/en/admin/tootctl.md @@ -30,7 +30,9 @@ RAILS_ENV=production bin/tootctl help ### `tootctl self-destruct` {#self-destruct} -Erase this server from the federation by broadcasting account Delete activities to all known other servers. This allows a "clean exit" from running a Mastodon server, as it leaves next to no cache behind on other servers. This command is always interactive and requires confirmation twice. +Erase this server from the federation by broadcasting account `Delete` activities to all known other servers. This allows a "clean exit" from running a Mastodon server, as it leaves next to no cache behind on other servers. This command is always interactive and requires confirmation twice. + +Prior to Mastodon 4.3.0, deletion jobs are enqueued immediately when running this command. Since Mastodon 4.3.0, this command will instead print out instructions to switch the server to self-destruct mode, which is responsible for sending the `Delete` activities. When a server is in self-destruct mode, it will also allow its users to log in and download their data, but it will not allow them to perform any other action. Calling `tootctl self-destruct` again on a server in self-destruct mode will print information on the progress of the self-destruction process. No local data is actually deleted because emptying the database or deleting the entire VPS is faster. If you run this command and then continue to operate the instance anyway, then there will be a state mismatch that might lead to glitches and issues with federation. @@ -38,11 +40,12 @@ No local data is actually deleted because emptying the database or deleting the **Make sure you know exactly what you are doing before running this command.** This operation is NOT reversible, and it can take a long time. The server will be in a BROKEN STATE after this command finishes. A running Sidekiq process is required, so do not shut down the server until the queues are fully cleared. {{< /hint >}} -`--dry-run` -: Print expected results only, without performing any actions. +`--dry-run` {{%removed%}} +: Print expected results only, without performing any actions. Removed in 4.3.0 **Version history:**\ -2.8.0 - added +2.8.0 - added\ +4.3.0 - removed `--dry-run`, introduced self-destruct mode ---