2018-03-25 02:00:46 +00:00
|
|
|
|
2017-12-23 23:20:59 +00:00
|
|
|
|
|
|
|
|
|
2017-09-03 05:08:56 +00:00
|
|
|
[](https://travis-ci.org/turt2live/matrix-dimension)
|
2017-05-26 18:59:34 +00:00
|
|
|
|
2020-07-16 00:24:23 +00:00
|
|
|
An open source integration manager for matrix clients, like Element. For help and support, please visit
|
2019-03-28 02:52:07 +00:00
|
|
|
us in [#dimension:t2bot.io](https://matrix.to/#/#dimension:t2bot.io) on Matrix.
|
2017-06-10 21:02:59 +00:00
|
|
|
|
2019-03-28 02:52:07 +00:00
|
|
|
# Installing Dimension / Running your own
|
2017-05-27 23:45:07 +00:00
|
|
|
|
2019-03-28 02:52:07 +00:00
|
|
|
See [docs/installing.md](./docs/installing.md) for more information on running Dimension.
|
2017-05-27 23:45:07 +00:00
|
|
|
|
2017-12-22 23:38:48 +00:00
|
|
|
### "Could not contact integrations server" error
|
|
|
|
|
|
2019-03-28 02:52:07 +00:00
|
|
|
1. **Check that federation is enabled and working on your homeserver.** If you're not intentionally
|
|
|
|
|
running Dimension in a non-federated environment, make sure that your homeserver is configured
|
|
|
|
|
correctly. If you are running in a non-federated environment, consult [docs/unfederated.md](./docs/unfederated.md).
|
|
|
|
|
2. **Check your SRV records and .well-known delegation.** If you are using SRV records to point to your
|
|
|
|
|
federation port, make sure that the hostname and port are correct, and that HTTPS is listening on that
|
|
|
|
|
port. Dimension will use the first record it sees and will only communicate over HTTPS. If you're using
|
|
|
|
|
.well-known delegation for federation, double check that is set up correctly.
|
|
|
|
|
3. **Verify the homeserver information in your configuration.** The name, access token, and client/
|
|
|
|
|
server API URL all need to be set to point towards your homeserver. It may also be necessary to set the
|
|
|
|
|
federation URL if you're running a private server.
|
2020-07-16 00:24:23 +00:00
|
|
|
4. **Run the troubleshooter.** If you're on Element, type `/addwidget https://dimension.t2bot.io/widgets/manager-test`
|
2019-03-28 02:52:07 +00:00
|
|
|
in a private room then click the button.
|
2017-09-12 02:04:31 +00:00
|
|
|
|
2017-10-09 02:47:38 +00:00
|
|
|
# Do I need an integrations manager?
|
|
|
|
|
|
2019-03-28 02:52:07 +00:00
|
|
|
Integration managers aim to ease a user's interaction with the various services a homeserver may
|
2020-07-16 00:24:23 +00:00
|
|
|
provide. Often times the integrations manager provided by Element, is more than suitable.
|
2019-03-28 02:52:07 +00:00
|
|
|
However, there are a few cases where running your own makes more sense:
|
2017-10-09 02:47:38 +00:00
|
|
|
|
2018-03-25 01:58:01 +00:00
|
|
|
* Wanting to self-host all aspects of your services (client, homeserver, and integrations)
|
2017-10-09 02:47:38 +00:00
|
|
|
* Wanting to advertise custom bots specific to your homeserver
|
2018-03-25 01:58:01 +00:00
|
|
|
* Corporate or closed environments where the default integration manager won't work
|
2017-10-09 02:47:38 +00:00
|
|
|
|
|
|
|
|
# How do integration managers work?
|
|
|
|
|
|
2019-03-28 02:52:07 +00:00
|
|
|
Integration managers sit between your users and your integrations (bots, bridges, etc). It helps guide
|
|
|
|
|
users through the configuration of your integrations for their rooms. The integrations manager can only
|
|
|
|
|
manage integrations it is configured for. For example, Modular can only provide configuration for the
|
|
|
|
|
bridges and bots running on matrix.org, while Dimension can provide configuration for your own bots and
|
|
|
|
|
bridges.
|
2017-10-09 02:47:38 +00:00
|
|
|
|
|
|
|
|
The infrastructure diagram looks something like this:
|
2018-03-25 02:03:20 +00:00
|
|
|
|
2017-10-09 02:47:38 +00:00
|
|
|
|
2019-03-28 02:52:07 +00:00
|
|
|
# Development
|
|
|
|
|
|
|
|
|
|
For more information about working on Dimension, see DEVELOPMENT.md.
|
|
|
|
|
|
2017-12-11 22:41:58 +00:00
|
|
|
# License
|
|
|
|
|
|
|
|
|
|
For information about Dimension's license, please see the LICENSE file included in this repository.
|
