|
@@ -67,17 +67,6 @@ hosted by someone else (e.g. matrix.org) - there is no single point of control
|
|
|
or mandatory service provider in Matrix, unlike WhatsApp, Facebook, Hangouts,
|
|
|
etc.
|
|
|
|
|
|
-Synapse ships with two basic demo Matrix clients: webclient (a basic group chat
|
|
|
-web client demo implemented in AngularJS) and cmdclient (a basic Python
|
|
|
-command line utility which lets you easily see what the JSON APIs are up to).
|
|
|
-
|
|
|
-Meanwhile, iOS and Android SDKs and clients are available from:
|
|
|
-
|
|
|
-- https://github.com/matrix-org/matrix-ios-sdk
|
|
|
-- https://github.com/matrix-org/matrix-ios-kit
|
|
|
-- https://github.com/matrix-org/matrix-ios-console
|
|
|
-- https://github.com/matrix-org/matrix-android-sdk
|
|
|
-
|
|
|
We'd like to invite you to join #matrix:matrix.org (via
|
|
|
https://matrix.org/docs/projects/try-matrix-now), run a homeserver, take a look
|
|
|
at the Matrix spec at https://matrix.org/docs/spec and API docs at
|
|
@@ -209,39 +198,36 @@ run (e.g. ``~/.synapse``), and::
|
|
|
synctl start
|
|
|
|
|
|
|
|
|
-Running The Demo Web Client
|
|
|
-===========================
|
|
|
-
|
|
|
-The homeserver runs a web client by default at https://localhost:8448/.
|
|
|
+Connecting to Synapse from a client
|
|
|
+===================================
|
|
|
|
|
|
-If this is the first time you have used the client from that browser (it uses
|
|
|
-HTML5 local storage to remember its config), you will need to log in to your
|
|
|
-account. If you don't yet have an account, because you've just started the
|
|
|
-homeserver for the first time, then you'll need to register one.
|
|
|
+The easiest way to try out your new Synapse installation is by connecting to it
|
|
|
+from a web client. We recommend the one at http://riot.im/app. You will need to
|
|
|
+specify a "Custom server" when you log on or register: set this to
|
|
|
+``https://localhost:8448`` - remember to specify the port (``:8448``) unless
|
|
|
+you changed the configuration. (Leave the identity server as the default - see
|
|
|
+`Identity servers`_.)
|
|
|
|
|
|
-Registering A New Account
|
|
|
--------------------------
|
|
|
+If all goes well you should at least be able to log in, create a room, and
|
|
|
+start sending messages.
|
|
|
|
|
|
-Your new user name will be formed partly from the hostname your server is
|
|
|
-running as, and partly from a localpart you specify when you create the
|
|
|
-account. Your name will take the form of::
|
|
|
+(The homeserver runs a web client by default at https://localhost:8448/, though
|
|
|
+as of the time of writing it is somewhat outdated and not really recommended -
|
|
|
+https://github.com/matrix-org/synapse/issues/1527).
|
|
|
|
|
|
- @localpart:my.domain.here
|
|
|
- (pronounced "at localpart on my dot domain dot here")
|
|
|
+Registering a new user from a client
|
|
|
+------------------------------------
|
|
|
|
|
|
-Specify your desired localpart in the topmost box of the "Register for an
|
|
|
-account" form, and click the "Register" button. Hostnames can contain ports if
|
|
|
-required due to lack of SRV records (e.g. @matthew:localhost:8448 on an
|
|
|
-internal synapse sandbox running on localhost).
|
|
|
+Your new user name will be formed partly from the ``server_name`` (see
|
|
|
+`Configuring synapse`_), and partly from a localpart you specify when you
|
|
|
+create the account. Your name will take the form of::
|
|
|
|
|
|
-If registration fails, you may need to enable it in the homeserver (see
|
|
|
-`Synapse Installation`_ above)
|
|
|
+ @localpart:my.domain.here
|
|
|
|
|
|
-Logging In To An Existing Account
|
|
|
----------------------------------
|
|
|
+(pronounced "at localpart on my dot domain dot here").
|
|
|
|
|
|
-Just enter the ``@localpart:my.domain.here`` Matrix user ID and password into
|
|
|
-the form and click the Login button.
|
|
|
+As when logging in, you will need to specify a "Custom server". Specify your
|
|
|
+desired ``localpart`` in the 'User name' box.
|
|
|
|
|
|
|
|
|
Security Note
|