Cloudron makes it easy to run web apps like WordPress, Nextcloud, GitLab on your server. Find out more or install now. (communication)

  • I installed a test-instance as well on a subdomain and neither federation nor the integrations are available. @girish ping me on the chat for debugging 😉

  • Staff

    @stantropics What can an admin do? Does he get some special controls in Riot? I couldn't figure out how to test it, so I left that part out.

  • @msbt The RIOT First Time Documentation notes that you need to tweak the Matrix Synapse home server. I found that the install uses the domain you give it but assumes 'matrix' is the subdomain. My subdomain was different and I had to tweak both the Matrix Synapse config and the RIOT config and then I restarted both, Then it worked. Check out the little drop-down tab "Documentation" and the First Time Setup, and follow the links there. I hope the issue is this simple.

    First Time Setup
    This app is only the frontend for Matrix. If you haven't done so already you should install the Matrix Synapse home server in a subdomain like

    This app is pre-configured to use the matrix installation at If you installed Synapse at another location, use the Web Terminal to edit /app/data/config.json to set the home server.

  • Staff

    I just announced this - . Can you guys give it a quick read and tell what to improve there?

  • @girish Do you want the comments here? All I can say is that this section:

    Riot is pre-configured to use matrix subdomain as the homeserver location.

    ought to be more evident. Like at the start of a paragraph. It's the sort of essential info that real coders like yourself just know but tinkerers like me don't.

    Another line that could use some clarifying is:

    SSH into the server and add the record like this

    My own impression from using Cloudron is that there is no need to ssh into the server and that using the built-in Terminal is the place to get things done if needed. I followed it literally, but I also think someone could read it and think "they must mean through the Console of the app...but which one, the Matrix server or the RIOT app?" and proceed to get confused because they can't navigate to


    Finally, in Step 3, after the line:

    If you installed synapse at, the client should be already able to connect

    maybe you could add something like "check Step 1" as a reminder because someone will prob skip it and then get here wondering what's going on.

    Finally, thank you again.

  • everything works fine now, no idea what caused the issues, all good, thanks @girish

  • Staff

    @scooke Thanks for the feedback, will fix up the docs.

    The SSH is a bit rough agreed 🙂 We will add a UI for .well-known records in the coming releases. For now, we wanted the apps out, so we can get some testing in parallel.

  • @msbt do you also have to set a redirect record for to make it work? Or is it just me?

  • Staff

    @stantropics You don't need to setup redirects. Is the website an app on Cloudron (or is it external to Cloudron) ? If it's the former, you just have to setup that .well-known record.

  • @stantropics I had a surfer app at and curl'ing the well-known url gave me a 404. After a bit of reconfiguring it worked, not sure if that's your setup as well, but maybe try reconfiguring the app and see if that solves your issue (if that's what you're asking)

  • @msbt @girish I am not using the root-domain ( at all currently. But matrix seems to not work if I don't set it up as a redirect for

  • Staff

    Can you post your setup here with example domain names of where you installed what - ? I can help out there.

    I will lock this thread, since 2 open posts for the same topic is confusing!

Log in to reply