commit fec6029
default
·
2025-01-04 18:31:44 +0000 UTC
parent 1e63ba8
Updated documentation.
3 files changed,
+20,
-14
+11,
-4
1@@ -288,7 +288,9 @@ Starts a migration from this account to the one set as an alias (see
2 section 'Migrating from snac to Mastodon').
3 .It Cm import_csv Ar basedir Ar uid
4 Imports CSV data files from a Mastodon export. This command expects the
5-following files to be in the current directory:
6+following files to be inside the
7+.Pa import/
8+subdirectory of a user's directory inside the server base directory:
9 .Pa bookmarks.csv ,
10 .Pa blocked_accounts.csv ,
11 .Pa lists.csv , and
12@@ -316,10 +318,15 @@ for a job to be assigned), input or output (processing I/O packets)
13 or stopped (not running, only to be seen while starting or stopping
14 the server).
15 .It Cm import_list Ar basedir Ar uid Ar file
16-Imports a Mastodon list in CSV format. This option can be used to
17-import "Mastodon Follow Packs".
18+Imports a Mastodon list in CSV format. The file must be stored inside the
19+.Pa import/
20+subdirectory of a user's directory inside the server base directory.
21+This option can be used to import "Mastodon Follow Packs".
22 .It Cm import_block_list Ar basedir Ar uid Ar file
23-Imports a Mastodon list of accounts to be blocked in CSV format.
24+Imports a Mastodon list of accounts to be blocked in CSV format. The
25+file must be stored inside the
26+.Pa import/
27+subdirectory of a user's directory inside the server base directory.
28 .El
29 .Ss Migrating an account to/from Mastodon
30 See
+3,
-0
1@@ -212,6 +212,9 @@ local timeline in previous months or other cached data.
2 .It Pa export/
3 This directory will contain exported data in Mastodon-compatible CSV format
4 after executing the 'export_csv' command-line operation.
5+.It Pa import/
6+Mastodon-compatible CSV files must be copied into this directory to use
7+any of the importing functions.
8 .It Pa server.pid
9 This file stores the server PID in a single text line.
10 .El
+6,
-10
1@@ -511,7 +511,9 @@ directory:
2 .Pa lists.csv , and
3 .Pa following_accounts.csv .
4 .Pp
5-2. From the directory where those files are stored, run
6+2. Copy all those files to the
7+.Pa import/
8+subdirectory of the user's directory inside the server base directory, and run
9 .Bd -literal -offset indent
10 snac import_csv $SNAC_BASEDIR destination
11 .Ed
12@@ -521,7 +523,9 @@ of all the ActivityPub servers involved (webfinger, accounts, posts, etc.). Some
13 may be transient and retried later. Also, if
14 .Nm
15 complains that it can't find any of these files, please check that they are really
16-stored in the current directory and that their names match exactly. Some of them may be
17+stored in the
18+.Pa import/
19+subdirectory and that their names match exactly. Some of them may be
20 empty (for example, if you didn't create any list) and that's fine.
21 .Pp
22 3. Again on your
23@@ -551,14 +555,6 @@ account from all accounts that followed the Mastodon one. According to the great
24 I linked above, this process may or may not start immediately, and its success may depend
25 heavily on how all the servers involved behave. Just cross your fingers and hope for the best.
26 .Pp
27-NOTE: If you run
28-.Nm
29-on OpenBSD, please take note that the pledge()/unveil() security system disallows
30-opening or creating files in the current directory; to do this operation, please
31-temporarily set the disable_openbsd_security option to true in the
32-.Pa server.json
33-file and restart before migrating. You can restore the option back to the default false
34-value afterwards.
35 .Ss Instance blocking
36 Full instances can be blocked. This operation must be done from
37 the command-line tool. See