davidbgk
/
larlet-fr-david-cache

<!doctype html><!-- This is a valid HTML5 document. -->
<!-- Screen readers, SEO, extensions and so on. -->
<html lang="fr">
<!-- Has to be within the first 1024 bytes, hence before the `title` element
  See: https://www.w3.org/TR/2012/CR-html5-20121217/document-metadata.html#charset -->
<meta charset="utf-8">
<!-- Why no `X-UA-Compatible` meta: https://stackoverflow.com/a/6771584 -->
<!-- The viewport meta is quite crowded and we are responsible for that.
  See: https://codepen.io/tigt/post/meta-viewport-for-2015 -->
<meta name="viewport" content="width=device-width,initial-scale=1">
<!-- Required to make a valid HTML5 document. -->
<title>Getting Mastodon running on a custom domain (archive) — David Larlet</title>
<meta name="description" content="Publication mise en cache pour en conserver une trace.">
<!-- That good ol' feed, subscribe :). -->
<link rel="alternate" type="application/atom+xml" title="Feed" href="/david/log/">
<!-- Generated from https://realfavicongenerator.net/ such a mess. -->
<link rel="apple-touch-icon" sizes="180x180" href="/static/david/icons2/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/static/david/icons2/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/static/david/icons2/favicon-16x16.png">
<link rel="manifest" href="/static/david/icons2/site.webmanifest">
<link rel="mask-icon" href="/static/david/icons2/safari-pinned-tab.svg" color="#07486c">
<link rel="shortcut icon" href="/static/david/icons2/favicon.ico">
<meta name="msapplication-TileColor" content="#f7f7f7">
<meta name="msapplication-config" content="/static/david/icons2/browserconfig.xml">
<meta name="theme-color" content="#f7f7f7" media="(prefers-color-scheme: light)">
<meta name="theme-color" content="#272727" media="(prefers-color-scheme: dark)">
<!-- Documented, feel free to shoot an email. -->
<link rel="stylesheet" href="/static/david/css/style_2021-01-20.css">
<!-- See https://www.zachleat.com/web/comprehensive-webfonts/ for the trade-off. -->
<link rel="preload" href="/static/david/css/fonts/triplicate_t4_poly_regular.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" crossorigin>
<link rel="preload" href="/static/david/css/fonts/triplicate_t4_poly_bold.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" crossorigin>
<link rel="preload" href="/static/david/css/fonts/triplicate_t4_poly_italic.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" crossorigin>
<link rel="preload" href="/static/david/css/fonts/triplicate_t3_regular.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: dark)" crossorigin>
<link rel="preload" href="/static/david/css/fonts/triplicate_t3_bold.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: dark)" crossorigin>
<link rel="preload" href="/static/david/css/fonts/triplicate_t3_italic.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: dark)" crossorigin>
<script>
    function toggleTheme(themeName) {
        document.documentElement.classList.toggle(
            'forced-dark',
            themeName === 'dark'
        )
        document.documentElement.classList.toggle(
            'forced-light',
            themeName === 'light'
        )
    }
    const selectedTheme = localStorage.getItem('theme')
    if (selectedTheme !== 'undefined') {
        toggleTheme(selectedTheme)
    }
</script>

  <meta name="robots" content="noindex, nofollow">
  <meta content="origin-when-cross-origin" name="referrer">
  <!-- Canonical URL for SEO purposes -->
  <link rel="canonical" href="https://til.simonwillison.net/mastodon/custom-domain-mastodon">

<body class="remarkdown h1-underline h2-underline h3-underline em-underscore hr-center ul-star pre-tick" data-instant-intensity="viewport-all">


<article>
  <header>
    <h1>Getting Mastodon running on a custom domain</h1>
  </header>
  <nav>
    <p class="center">
      <a href="/david/" title="Aller à l’accueil"><svg class="icon icon-home">
        <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-home"></use>
      </svg> Accueil</a> •
      <a href="https://til.simonwillison.net/mastodon/custom-domain-mastodon" title="Lien vers le contenu original">Source originale</a>
    </p>
  </nav>
  <hr>
  <p>This TIL is mainly a rehash of these two articles by Jacob and Andrew:</p>

<p>I decided if I was going to get into Mastodon I wanted it on a domain that I controlled.</p>
<p>Here's my <a href="https://github.com/simonw/simonwillisonblog/issues/290">research issue</a> where I first figured this all out.</p>
<h2><a id="user-content-mastohost" class="anchor" aria-hidden="true" href="#mastohost"><span aria-hidden="true" class="octicon octicon-link"></span></a>masto.host</h2>
<p>Both Andrew and Jacob chose <a href="https://masto.host/" rel="nofollow">masto.host</a> as a managed host for their instances. Mastodon is open source and runs on Ruby, PostgreSQL and Redis, but managing those is enough of a hassle that I'd much rather have someone else do it for me.</p>
<p>Since Andrew and Jacob had done the due diligence on this already I just went with the one they are using.</p>
<p>I see this as a pleasantly low-risk vendor, because since I'm pointing my own domain at it I can move elsewhere pretty easily if I need to.</p>
<p>My impressions of it so far have been excellent - especially the speed of their customer support (see later note).</p>
<h2><a id="user-content-pay-for-an-account-then-set-up-a-cname" class="anchor" aria-hidden="true" href="#pay-for-an-account-then-set-up-a-cname"><span aria-hidden="true" class="octicon octicon-link"></span></a>Pay for an account, then set up a CNAME</h2>
<p>I paid for a subscription, then added the following configuration to my Cloudflare DNS:</p>
<p><a target="_blank" rel="noopener noreferrer nofollow" href="https://user-images.githubusercontent.com/9599/199629095-2704cd43-1046-4bff-8460-f756d2510f97.png"><img src="https://user-images.githubusercontent.com/9599/199629095-2704cd43-1046-4bff-8460-f756d2510f97.png" alt="CNAME of fedi pointed to vip.masto.host, Proxy states of DNS only"></a></p>
<p><code>masto.host</code> provided detailed instructions for this, including making sure to turn off the Cloudflare caching proxy.</p>
<p>This started working within less than a minute - and <a href="https://fedi.simonwillison.net/" rel="nofollow">https://fedi.simonwillison.net/</a> was live.</p>
<h2><a id="user-content-creating-an-account-promoting-it-to-admin" class="anchor" aria-hidden="true" href="#creating-an-account-promoting-it-to-admin"><span aria-hidden="true" class="octicon octicon-link"></span></a>Creating an account, promoting it to admin</h2>
<p>Once my instance was live I used the default account creation flow to create myself an account.</p>
<p>I then used the <a href="https://my.masto.host/hosting" rel="nofollow">https://my.masto.host/hosting</a> interface to find the "Change User Role" option and used that to upgrade my new user account to administrator status.</p>
<p>Having done that I gained access to the <a href="https://fedi.simonwillison.net/admin/settings/edit" rel="nofollow">https://fedi.simonwillison.net/admin/settings/edit</a> interface, where I blocked anyone else from creating an account and changed the site theme to "Mastodon (Light)" (which I like better).</p>
<p><a target="_blank" rel="noopener noreferrer" href="https://user-images.githubusercontent.com/9599/199629280-4add2ded-752f-4d7c-b9b8-91bda4a81811.png"><img alt="Screenshot of the Mastodon site settings panel" src="https://user-images.githubusercontent.com/9599/199629280-4add2ded-752f-4d7c-b9b8-91bda4a81811.png"></a></p>
<p>Frustratingly these settings require an email address, which is shown publicly on a page on the site. I used iCloud in Mobile Safari on my phone to create a disposable email address to use here.</p>
<h2><a id="user-content-getting-a-vanity-address" class="anchor" aria-hidden="true" href="#getting-a-vanity-address"><span aria-hidden="true" class="octicon octicon-link"></span></a>Getting a vanity address</h2>
<p>I wanted <code>@simon@simonwillison.net</code> as my ID, but it started out as <code>@simon@fedi.simonwillison.net</code>.</p>
<p>To do this, you need to set up some <code>/.well-known/...</code> URLs on your core domain.</p>
<p>I exactly copied <a href="https://aeracode.org/2022/11/01/fediverse-custom-domains/" rel="nofollow">how Andrew did this</a>. Here's <a href="https://github.com/simonw/simonwillisonblog/commit/f112e57f8619852985f15a71c00309f5046b8f1a">my commit to my Django blog</a>.</p>
<p>There's one last step here: as explained in <a href="https://masto.host/mastodon-usernames-different-from-the-domain-used-for-installation/" rel="nofollow">Mastodon usernames different from the domain used for installation</a> you need to update the <code>LOCAL_DOMAIN</code> and <code>WEB_DOMAIN</code> settings. These aren't currently available for <code>masto.host</code> customers to change, but you can email their support team about it.</p>
<p>I emailed them and they fixed it for me six minutes later! And now <code>@simon@simonwillison.net</code> both works and is displayed on <a href="https://fedi.simonwillison.net/@simon" rel="nofollow">https://fedi.simonwillison.net/@simon</a></p>
<h2><a id="user-content-finding-people-to-follow" class="anchor" aria-hidden="true" href="#finding-people-to-follow"><span aria-hidden="true" class="octicon octicon-link"></span></a>Finding people to follow</h2>
<p>I started by following <code>@jacob@jacobian.org</code> and <code>@andrew@aeracode.org</code>. Then I looked at who they were following. Then I tweeted about my new account and started following-back people who followed me.</p>
<h2><a id="user-content-the-iphone-app-is-really-good" class="anchor" aria-hidden="true" href="#the-iphone-app-is-really-good"><span aria-hidden="true" class="octicon octicon-link"></span></a>The iPhone app is really good</h2>
<p>I installed <a href="https://apps.apple.com/us/app/mastodon-for-iphone-and-ipad/id1571998974" rel="nofollow">the official Mastodon app</a> on my iPhone. It's really good! I signed in by giving it my <code>https://fedi.simonwillison.net/</code> address, and now it's sending me notifications and generally working exactly how I would want it to.</p>
</article>


<hr>

<footer>
  <p>
    <a href="/david/" title="Aller à l’accueil"><svg class="icon icon-home">
        <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-home"></use>
      </svg> Accueil</a> •
    <a href="/david/log/" title="Accès au flux RSS"><svg class="icon icon-rss2">
        <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-rss2"></use>
      </svg> Suivre</a> •
    <a href="http://larlet.com" title="Go to my English profile" data-instant><svg class="icon icon-user-tie">
        <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-user-tie"></use>
      </svg> Pro</a> •
    <a href="mailto:david%40larlet.fr" title="Envoyer un courriel"><svg class="icon icon-mail">
        <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-mail"></use>
      </svg> Email</a> •
    <abbr class="nowrap" title="Hébergeur : Alwaysdata, 62 rue Tiquetonne 75002 Paris, +33184162340"><svg class="icon icon-hammer2">
        <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-hammer2"></use>
      </svg> Légal</abbr>
  </p>
  <template id="theme-selector">
      <form>
          <fieldset>
              <legend><svg class="icon icon-brightness-contrast">
                <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-brightness-contrast"></use>
              </svg> Thème</legend>
              <label>
                  <input type="radio" value="auto" name="chosen-color-scheme" checked> Auto
              </label>
              <label>
                  <input type="radio" value="dark" name="chosen-color-scheme"> Foncé
              </label>
              <label>
                  <input type="radio" value="light" name="chosen-color-scheme"> Clair
              </label>
          </fieldset>
      </form>
  </template>
</footer>
<script src="/static/david/js/instantpage-5.1.0.min.js" type="module"></script>
<script>
    function loadThemeForm(templateName) {
        const themeSelectorTemplate = document.querySelector(templateName)
        const form = themeSelectorTemplate.content.firstElementChild
        themeSelectorTemplate.replaceWith(form)

        form.addEventListener('change', (e) => {
            const chosenColorScheme = e.target.value
            localStorage.setItem('theme', chosenColorScheme)
            toggleTheme(chosenColorScheme)
        })

        const selectedTheme = localStorage.getItem('theme')
        if (selectedTheme && selectedTheme !== 'undefined') {
            form.querySelector(`[value="${selectedTheme}"]`).checked = true
        }
    }

    const prefersColorSchemeDark = '(prefers-color-scheme: dark)'
    window.addEventListener('load', () => {
        let hasDarkRules = false
        for (const styleSheet of Array.from(document.styleSheets)) {
            let mediaRules = []
            for (const cssRule of styleSheet.cssRules) {
                if (cssRule.type !== CSSRule.MEDIA_RULE) {
                    continue
                }
                // WARNING: Safari does not have/supports `conditionText`.
                if (cssRule.conditionText) {
                    if (cssRule.conditionText !== prefersColorSchemeDark) {
                        continue
                    }
                } else {
                    if (cssRule.cssText.startsWith(prefersColorSchemeDark)) {
                        continue
                    }
                }
                mediaRules = mediaRules.concat(Array.from(cssRule.cssRules))
            }

            // WARNING: do not try to insert a Rule to a styleSheet you are
            // currently iterating on, otherwise the browser will be stuck
            // in a infinite loop…
            for (const mediaRule of mediaRules) {
                styleSheet.insertRule(mediaRule.cssText)
                hasDarkRules = true
            }
        }
        if (hasDarkRules) {
            loadThemeForm('#theme-selector')
        }
    })
</script>
</body>
</html>