Skip to content
This repository has been archived by the owner on Aug 10, 2023. It is now read-only.

Update link to Integration manager #428

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/installing.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,8 +138,8 @@ and see instructions for configuring Element. If you don't, your configuration i
intended - double check that all the configuration is set up and visit [#dimension:t2bot.io](https://matrix.to/#/#dimension:t2bot.io)
for further help.

After configuring Element, click the integrations button (4 squares in the top right of any room) and
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe just a nitpick, but the mobile clients on Android and iOS still have the integrations button on the top right. I think it makes sense to explain both variants.

then click the gear icon. If you don't see a gear icon, you're not an admin in the config. This is
After configuring Element, click the the "Add widgets, bridges & bots" link in the Room Info of any room and
then click the gear icon. If you don't see a gear icon, you're not an admin in the config. Alternatively, open `https://dimension.<your-domain>/riot-app/admin`. This is
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The direct URL is not meant to be used outside of the client frame, and won't work for new installations.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's been a while now, but remember that I actually had to do it using the direct link. Creating a room and using the "Add widgets, bridges & bots" link resulted in a access token belongs to real user error, if I recall correctly

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That error is intentional and a sign that the deployment was not done correctly. Dimension is deliberately designed to work within the context of a client and not outside of it, and it needs a dedicated access token in its config to avoid issues relating to database consistency.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is there any documentation about this error and how to avoid it? I remember I couldn't find anything a couple of weeks back.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The config.yaml comment for access_token specifically mentions

The access token Dimension should use for miscellaneous access to the homeserver, and for tracking custom sticker pack updates. This should be a user configured on the homeserver and be dedicated to Dimension (create a user named "dimension" on your homeserver).

where you'll configure different integrations as Dimension doesn't ship with anything enabled by
default - click around and start enabling things.

Expand Down