A place to cache linked articles (think custom and personal wayback machine)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201
  1. <!doctype html><!-- This is a valid HTML5 document. -->
  2. <!-- Screen readers, SEO, extensions and so on. -->
  3. <html lang="fr">
  4. <!-- Has to be within the first 1024 bytes, hence before the `title` element
  5. See: https://www.w3.org/TR/2012/CR-html5-20121217/document-metadata.html#charset -->
  6. <meta charset="utf-8">
  7. <!-- Why no `X-UA-Compatible` meta: https://stackoverflow.com/a/6771584 -->
  8. <!-- The viewport meta is quite crowded and we are responsible for that.
  9. See: https://codepen.io/tigt/post/meta-viewport-for-2015 -->
  10. <meta name="viewport" content="width=device-width,initial-scale=1">
  11. <!-- Required to make a valid HTML5 document. -->
  12. <title>Getting Mastodon running on a custom domain (archive) — David Larlet</title>
  13. <meta name="description" content="Publication mise en cache pour en conserver une trace.">
  14. <!-- That good ol' feed, subscribe :). -->
  15. <link rel="alternate" type="application/atom+xml" title="Feed" href="/david/log/">
  16. <!-- Generated from https://realfavicongenerator.net/ such a mess. -->
  17. <link rel="apple-touch-icon" sizes="180x180" href="/static/david/icons2/apple-touch-icon.png">
  18. <link rel="icon" type="image/png" sizes="32x32" href="/static/david/icons2/favicon-32x32.png">
  19. <link rel="icon" type="image/png" sizes="16x16" href="/static/david/icons2/favicon-16x16.png">
  20. <link rel="manifest" href="/static/david/icons2/site.webmanifest">
  21. <link rel="mask-icon" href="/static/david/icons2/safari-pinned-tab.svg" color="#07486c">
  22. <link rel="shortcut icon" href="/static/david/icons2/favicon.ico">
  23. <meta name="msapplication-TileColor" content="#f7f7f7">
  24. <meta name="msapplication-config" content="/static/david/icons2/browserconfig.xml">
  25. <meta name="theme-color" content="#f7f7f7" media="(prefers-color-scheme: light)">
  26. <meta name="theme-color" content="#272727" media="(prefers-color-scheme: dark)">
  27. <!-- Documented, feel free to shoot an email. -->
  28. <link rel="stylesheet" href="/static/david/css/style_2021-01-20.css">
  29. <!-- See https://www.zachleat.com/web/comprehensive-webfonts/ for the trade-off. -->
  30. <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>
  31. <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>
  32. <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>
  33. <link rel="preload" href="/static/david/css/fonts/triplicate_t3_regular.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: dark)" crossorigin>
  34. <link rel="preload" href="/static/david/css/fonts/triplicate_t3_bold.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: dark)" crossorigin>
  35. <link rel="preload" href="/static/david/css/fonts/triplicate_t3_italic.woff2" as="font" type="font/woff2" media="(prefers-color-scheme: dark)" crossorigin>
  36. <script>
  37. function toggleTheme(themeName) {
  38. document.documentElement.classList.toggle(
  39. 'forced-dark',
  40. themeName === 'dark'
  41. )
  42. document.documentElement.classList.toggle(
  43. 'forced-light',
  44. themeName === 'light'
  45. )
  46. }
  47. const selectedTheme = localStorage.getItem('theme')
  48. if (selectedTheme !== 'undefined') {
  49. toggleTheme(selectedTheme)
  50. }
  51. </script>
  52. <meta name="robots" content="noindex, nofollow">
  53. <meta content="origin-when-cross-origin" name="referrer">
  54. <!-- Canonical URL for SEO purposes -->
  55. <link rel="canonical" href="https://til.simonwillison.net/mastodon/custom-domain-mastodon">
  56. <body class="remarkdown h1-underline h2-underline h3-underline em-underscore hr-center ul-star pre-tick" data-instant-intensity="viewport-all">
  57. <article>
  58. <header>
  59. <h1>Getting Mastodon running on a custom domain</h1>
  60. </header>
  61. <nav>
  62. <p class="center">
  63. <a href="/david/" title="Aller à l’accueil"><svg class="icon icon-home">
  64. <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-home"></use>
  65. </svg> Accueil</a> •
  66. <a href="https://til.simonwillison.net/mastodon/custom-domain-mastodon" title="Lien vers le contenu original">Source originale</a>
  67. </p>
  68. </nav>
  69. <hr>
  70. <p>This TIL is mainly a rehash of these two articles by Jacob and Andrew:</p>
  71. <p>I decided if I was going to get into Mastodon I wanted it on a domain that I controlled.</p>
  72. <p>Here's my <a href="https://github.com/simonw/simonwillisonblog/issues/290">research issue</a> where I first figured this all out.</p>
  73. <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>
  74. <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>
  75. <p>Since Andrew and Jacob had done the due diligence on this already I just went with the one they are using.</p>
  76. <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>
  77. <p>My impressions of it so far have been excellent - especially the speed of their customer support (see later note).</p>
  78. <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>
  79. <p>I paid for a subscription, then added the following configuration to my Cloudflare DNS:</p>
  80. <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>
  81. <p><code>masto.host</code> provided detailed instructions for this, including making sure to turn off the Cloudflare caching proxy.</p>
  82. <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>
  83. <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>
  84. <p>Once my instance was live I used the default account creation flow to create myself an account.</p>
  85. <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>
  86. <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>
  87. <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>
  88. <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>
  89. <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>
  90. <p>I wanted <code>@simon@simonwillison.net</code> as my ID, but it started out as <code>@simon@fedi.simonwillison.net</code>.</p>
  91. <p>To do this, you need to set up some <code>/.well-known/...</code> URLs on your core domain.</p>
  92. <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>
  93. <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>
  94. <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>
  95. <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>
  96. <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>
  97. <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>
  98. <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>
  99. </article>
  100. <hr>
  101. <footer>
  102. <p>
  103. <a href="/david/" title="Aller à l’accueil"><svg class="icon icon-home">
  104. <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-home"></use>
  105. </svg> Accueil</a> •
  106. <a href="/david/log/" title="Accès au flux RSS"><svg class="icon icon-rss2">
  107. <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-rss2"></use>
  108. </svg> Suivre</a> •
  109. <a href="http://larlet.com" title="Go to my English profile" data-instant><svg class="icon icon-user-tie">
  110. <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-user-tie"></use>
  111. </svg> Pro</a> •
  112. <a href="mailto:david%40larlet.fr" title="Envoyer un courriel"><svg class="icon icon-mail">
  113. <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-mail"></use>
  114. </svg> Email</a> •
  115. <abbr class="nowrap" title="Hébergeur : Alwaysdata, 62 rue Tiquetonne 75002 Paris, +33184162340"><svg class="icon icon-hammer2">
  116. <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-hammer2"></use>
  117. </svg> Légal</abbr>
  118. </p>
  119. <template id="theme-selector">
  120. <form>
  121. <fieldset>
  122. <legend><svg class="icon icon-brightness-contrast">
  123. <use xlink:href="/static/david/icons2/symbol-defs-2021-12.svg#icon-brightness-contrast"></use>
  124. </svg> Thème</legend>
  125. <label>
  126. <input type="radio" value="auto" name="chosen-color-scheme" checked> Auto
  127. </label>
  128. <label>
  129. <input type="radio" value="dark" name="chosen-color-scheme"> Foncé
  130. </label>
  131. <label>
  132. <input type="radio" value="light" name="chosen-color-scheme"> Clair
  133. </label>
  134. </fieldset>
  135. </form>
  136. </template>
  137. </footer>
  138. <script src="/static/david/js/instantpage-5.1.0.min.js" type="module"></script>
  139. <script>
  140. function loadThemeForm(templateName) {
  141. const themeSelectorTemplate = document.querySelector(templateName)
  142. const form = themeSelectorTemplate.content.firstElementChild
  143. themeSelectorTemplate.replaceWith(form)
  144. form.addEventListener('change', (e) => {
  145. const chosenColorScheme = e.target.value
  146. localStorage.setItem('theme', chosenColorScheme)
  147. toggleTheme(chosenColorScheme)
  148. })
  149. const selectedTheme = localStorage.getItem('theme')
  150. if (selectedTheme && selectedTheme !== 'undefined') {
  151. form.querySelector(`[value="${selectedTheme}"]`).checked = true
  152. }
  153. }
  154. const prefersColorSchemeDark = '(prefers-color-scheme: dark)'
  155. window.addEventListener('load', () => {
  156. let hasDarkRules = false
  157. for (const styleSheet of Array.from(document.styleSheets)) {
  158. let mediaRules = []
  159. for (const cssRule of styleSheet.cssRules) {
  160. if (cssRule.type !== CSSRule.MEDIA_RULE) {
  161. continue
  162. }
  163. // WARNING: Safari does not have/supports `conditionText`.
  164. if (cssRule.conditionText) {
  165. if (cssRule.conditionText !== prefersColorSchemeDark) {
  166. continue
  167. }
  168. } else {
  169. if (cssRule.cssText.startsWith(prefersColorSchemeDark)) {
  170. continue
  171. }
  172. }
  173. mediaRules = mediaRules.concat(Array.from(cssRule.cssRules))
  174. }
  175. // WARNING: do not try to insert a Rule to a styleSheet you are
  176. // currently iterating on, otherwise the browser will be stuck
  177. // in a infinite loop…
  178. for (const mediaRule of mediaRules) {
  179. styleSheet.insertRule(mediaRule.cssText)
  180. hasDarkRules = true
  181. }
  182. }
  183. if (hasDarkRules) {
  184. loadThemeForm('#theme-selector')
  185. }
  186. })
  187. </script>
  188. </body>
  189. </html>