summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorGravatar default2024-03-12 10:48:13 +0100
committerGravatar default2024-03-12 10:48:13 +0100
commitcc0fc68d7c0b45208146f7f7141f99e1fe403932 (patch)
tree6457e9fef3cdda226fba169f654201a4e9813e7d /doc
parentUpdated documentation. (diff)
downloadsnac2-cc0fc68d7c0b45208146f7f7141f99e1fe403932.tar.gz
snac2-cc0fc68d7c0b45208146f7f7141f99e1fe403932.tar.xz
snac2-cc0fc68d7c0b45208146f7f7141f99e1fe403932.zip
Updated documentation.
Diffstat (limited to 'doc')
-rw-r--r--doc/snac.54
-rw-r--r--doc/snac.829
2 files changed, 29 insertions, 4 deletions
diff --git a/doc/snac.5 b/doc/snac.5
index 6207d32..e0cc9c2 100644
--- a/doc/snac.5
+++ b/doc/snac.5
@@ -110,7 +110,9 @@ This file contains the list of public posts from all users in the server.
110This (optional) file contains a list of regular expressions, one per line, to be 110This (optional) file contains a list of regular expressions, one per line, to be
111applied to the content of all incoming posts; if any of them match, the post is 111applied to the content of all incoming posts; if any of them match, the post is
112rejected. This brings the flexibility and destruction power of regular expressions 112rejected. This brings the flexibility and destruction power of regular expressions
113to your Fediverse experience. To be used wisely. 113to your Fediverse experience. To be used wisely (see
114.Xr snac 8
115for more information).
114.El 116.El
115.Pp 117.Pp
116Each user directory is a subdirectory of 118Each user directory is a subdirectory of
diff --git a/doc/snac.8 b/doc/snac.8
index 85106d3..e8a3562 100644
--- a/doc/snac.8
+++ b/doc/snac.8
@@ -230,9 +230,32 @@ for details. Further, every user can have a private CSS file in their
230that will be served instead of the server-wide one. 230that will be served instead of the server-wide one.
231It's not modifiable from the web interface to avoid users 231It's not modifiable from the web interface to avoid users
232shooting themselves in the foot by destroying everything. 232shooting themselves in the foot by destroying everything.
233.Ss Old Data Purging 233.Ss SPAM Mitigation
234From version 2.06, there is no longer a need to add a special 234There have been some SPAM attacks on the Fediverse and, as too many
235cron job for purging old data, as this is managed internally. 235instances and server implementations out there still allow automatic
236account creation, it will only get worse.
237.Nm
238includes some (not very strong) tools for trying to survive the SPAM
239flood that will eventually happen.
240.Pp
241The
242.Ic min_account_age
243field in the main configuration file allows setting a minimum age (in
244seconds) to consider too recently created accounts suspicious of being
245a potential source of SPAM. This is a naïve assumption, because spammers
246can create accounts, let them dormant for a while and then start to use
247them. Also, some ActivityPub implementations don't even bother to return
248a creation date for their accounts, so this is not very useful.
249.Pp
250From version 2.50, post content can be filtered out by regular expressions.
251These weapons of mass destruction can be written into the
252.Ic filter_reject.txt
253file in the server base directory, one per line; if this file exists,
254all posts' content will be matched against these regexes, one by one, and
255any match will make the post to be rejected. If you don't know about regular
256expressions, don't use this option (or learn about them in some tutorial,
257there are gazillions of them out there), as you and your users may start
258missing posts.
236.Ss ActivityPub Support 259.Ss ActivityPub Support
237These are the following activities and objects that 260These are the following activities and objects that
238.Nm 261.Nm