diff --git a/develop/setup/installation.html b/develop/setup/installation.html
index b2c973b217..ac0efe7b8a 100644
--- a/develop/setup/installation.html
+++ b/develop/setup/installation.html
@@ -500,8 +500,12 @@ and <code>notif_from</code> fields filled out. You may also need to set <code>s
<p>If email is not configured, password reset, registration and notifications via
email will be disabled.</p>
<h3 id="registering-a-user"><a class="header" href="#registering-a-user">Registering a user</a></h3>
-<p>The easiest way to create a new user is to do so from a client like <a href="https://element.io/">Element</a>.</p>
-<p>Alternatively, you can do so from the command line. This can be done as follows:</p>
+<p>One way to create a new user is to do so from a client like
+<a href="https://element.io/">Element</a>. This requires registration to be enabled via
+the
+<a href="../usage/configuration/config_documentation.html#enable_registration"><code>enable_registration</code></a>
+setting.</p>
+<p>Alternatively, you can create new users from the command line. This can be done as follows:</p>
<ol>
<li>If synapse was installed via pip, activate the virtualenv as follows (if Synapse was
installed via a prebuilt package, <code>register_new_matrix_user</code> should already be
@@ -512,7 +516,7 @@ synctl start # if not already running
</code></pre>
</li>
<li>Run the following command:
-<pre><code class="language-sh">register_new_matrix_user -c homeserver.yaml http://localhost:8008
+<pre><code class="language-sh">register_new_matrix_user -c homeserver.yaml
</code></pre>
</li>
</ol>
@@ -524,12 +528,13 @@ Confirm password:
Make admin [no]:
Success!
</code></pre>
-<p>This process uses a setting <code>registration_shared_secret</code> in
-<code>homeserver.yaml</code>, which is shared between Synapse itself and the
-<code>register_new_matrix_user</code> script. It doesn't matter what it is (a random
-value is generated by <code>--generate-config</code>), but it should be kept secret, as
-anyone with knowledge of it can register users, including admin accounts,
-on your server even if <code>enable_registration</code> is <code>false</code>.</p>
+<p>This process uses a setting
+<a href="../usage/configuration/config_documentation.html#registration_shared_secret"><code>registration_shared_secret</code></a>,
+which is shared between Synapse itself and the <code>register_new_matrix_user</code>
+script. It doesn't matter what it is (a random value is generated by
+<code>--generate-config</code>), but it should be kept secret, as anyone with knowledge of
+it can register users, including admin accounts, on your server even if
+<code>enable_registration</code> is <code>false</code>.</p>
<h3 id="setting-up-a-turn-server"><a class="header" href="#setting-up-a-turn-server">Setting up a TURN server</a></h3>
<p>For reliable VoIP calls to be routed via this homeserver, you MUST configure
a TURN server. See <a href="../turn-howto.html">TURN setup</a> for details.</p>
|