From a7cdb95ee9b4bddce58915d4feaf3ab03f18ce86 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ond=C5=99ej=20Pokorn=C3=BD?= Date: Sun, 9 Sep 2018 20:00:45 +0200 Subject: [PATCH] Added the content of .well-known/host-meta file (#703) * Added the content of .well-known/host-meta file Spent quite a lot of time today figuring out what should the webfinger file contain when the simple redirect can't be easily configured. Hopefully this clears thing up. * Edits from comments Disclaimer: I'm new to Github, hopefully I'm doing it right. --- Running-Mastodon/Serving_a_different_domain.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/Running-Mastodon/Serving_a_different_domain.md b/Running-Mastodon/Serving_a_different_domain.md index 2f74a8a3..1c424b9f 100644 --- a/Running-Mastodon/Serving_a_different_domain.md +++ b/Running-Mastodon/Serving_a_different_domain.md @@ -31,7 +31,7 @@ As said earlier, each Mastodon user has an `acct:` URI, which is used for discov When you add `@user@example.org`, a webfinger query is performed. This is done in two steps: 1. Querying `https://example.org/.well-known/host-meta` (where the domain of the URL matches the domain part of the `acct:` URI) to get information on how to perform the query. - This file will indeed contain a URL template of the form `https://somedomain.org/.well-known/webfinger?resource={uri}` that + The host-meta file should contain a URL template of the form `https://somedomain.org/.well-known/webfinger?resource={uri}` that will be used in the second step. 2. Fill the returned template with the `acct:` URI to be queried and perform the query: `https://somedomain.org/.well-known/webfinger?resource=acct:user@example.org` @@ -56,7 +56,7 @@ may cause remote instances to register different accounts with the same author/a - `WEB_DOMAIN` is the domain used for any URL generated for your instance, including the author/actor URIs. In our case, that would be `social.example.org`. -### Configuring domain.org +### Configuring example.org Now, you have Mastodon running at `https://social.example.org` as well as a website at `https://example.org`. If you recall how webfinger queries work, the first step is to query `https://example.org/.well-known/host-meta`, @@ -74,6 +74,14 @@ location = /.well-known/host-meta { in example.org's server block. +Alternatively, you can serve the file from your hosting. The full content of the file: +```XML + + + + +``` + ## Known issues There are a few known issues with Mastodon: