diff --git a/docs/dev/mastodon.md b/docs/dev/mastodon.md
index d010da3..1ec24cd 100644
--- a/docs/dev/mastodon.md
+++ b/docs/dev/mastodon.md
@@ -4,7 +4,10 @@
 
 (Optional)
 
-Log in to your Mastodon instance with an admin account and create a new
-OAuth application:
-
-https://kosmos.social/settings/applications/new
+* Log in to your Mastodon instance with an admin account
+* Create a new OAuth application (Settings -> Development)
+* Select `admin:read` access in the permissions
+* After confirming, click on the application name in the list, and copy the
+  access token
+* Configure it as `MASTODON_AUTH_TOKEN` via environment variable, or on
+  Admin -> Settings -> Services -> Mastodon