commit 7fecec1

default  ·  2023-04-12 09:54:42 +0000 UTC
parent 168e1ce
Updated documentation.
2 files changed,  +28, -6
+12, -1
 1@@ -205,10 +205,21 @@ argument is -e,  the external editor defined by the EDITOR
 2 environment variable will be invoked to prepare a message; if
 3 it's - (a lonely hyphen), the post content will be read from stdin.
 4 .El
 5-.Ss Migrating from Mastodon
 6+.Ss Migrating an account from Mastodon
 7 See 
 8 .Xr snac 8
 9 for details.
10+.Ss Using Mastodon-compatible apps
11+Since version 2.27,
12+.Nm
13+includes support for the Mastodon API, so you can use Mastodon-compatible
14+mobile and desktop applications to access your account. Given a correctly
15+configured server, the usage of these programs should be straightforward.
16+Please take note that they will show your timeline in a 'Mastodon fashion'
17+(i.e., as a plain list of posts), so you will lose the fancy, nested thread
18+post display with the most active threads at the top that the web interface of
19+.Nm
20+provides.
21 .Sh ENVIRONMENT
22 .Bl -tag -width Ds
23 .It Ev DEBUG
+16, -5
 1@@ -331,21 +331,32 @@ snac httpd /home/snacusr/fedidata
 2 Edit the nginx configuration and add the following snippet to the
 3 example.com server section:
 4 .Bd -literal -offset indent
 5+# main web access point
 6+location /fedi {
 7+    proxy_pass http://localhost:8001;
 8+    proxy_set_header Host $http_host;
 9+}
10+# webfinger
11 location /.well-known/webfinger {
12     proxy_pass http://localhost:8001;
13     proxy_set_header Host $http_host;
14 }
15-
16-# optional
17-location /.well-known/nodeinfo {
18+# Mastodon API (entry point)
19+location /api/v1/ {
20     proxy_pass http://localhost:8001;
21     proxy_set_header Host $http_host;
22 }
23-
24-location /fedi {
25+# Mastodon API (OAuth support)
26+location /oauth {
27     proxy_pass http://localhost:8001;
28     proxy_set_header Host $http_host;
29 }
30+# optional
31+location /.well-known/nodeinfo {
32+    proxy_pass http://localhost:8001;
33+    proxy_set_header Host $http_host;
34+}
35+
36 .Ed
37 .Pp
38 Restart the nginx daemon and connect to https://example.com/fedi/walter.