lemmy-docs icon indicating copy to clipboard operation
lemmy-docs copied to clipboard

Add documentation for running Lemmy on separate subdomains

Open SolninjaA opened this issue 8 months ago • 1 comments

As discussed in the Lemmy Matrix chat, this PR adds documentation for running the Lemmy backend and frontend on separate subdomains.

Important

The Traefik configuration has been tested, however I am unable to test the NGINX configuration. If possible, it would be great if someone could test it.

Notes

  • This PR references a third-party Docker container (for the UI) which is required for this configuration.

Please let me know if there are any issues! I'm always hoping for constructive feedback.

SolninjaA avatar Mar 25 '25 10:03 SolninjaA

I just pushed another commit which fixed a conflict with the other services I was running.

I'll add the other proposed changes once I get some more information 🙂

SolninjaA avatar Mar 28 '25 07:03 SolninjaA

I just pushed the changes discussed here.

I'll test Nutomic's suggestion about the required endpoints using the "fixed" version of Lemmy UI, either when it is pushed to a new release, or if I test it with a local Docker image.

SolninjaA avatar Apr 03 '25 01:04 SolninjaA

Lets wait until the lemmy-ui PR is merged, then it can also be backported for 0.19.11.

Nutomic avatar Apr 03 '25 11:04 Nutomic

I just made the changes discussed here, and also changed the Traefik configuration to match the final configuration when the new "fixed" Lemmy UI releases.

Also, in relation to my previous comment, I tried to test Nutomic's suggestion with my branch of Lemmy UI before it got merged. However, it seems my changes are only represented when running with pnpm dev, and I cannot get the changes to reflect in any newly built Docker container. I can only run Lemmy UI in a Docker container with my current Lemmy setup, therefore I will have to wait until the Lemmy UI changes have been merged to test Nutomic's suggestion.

Considerations

  • I'm unsure which release the Lemmy UI fix will be implemented in, so currently the Lemmy UI image is image: **UPDATE WITH THE FIXED LEMMY UI VERSION** in the Traefik configuration. This needs to be changed prior to merging this PR.
  • I haven't changed the NGINX configuration as it seems no one else is willing to test it, so I will have to test it myself once the Lemmy UI changes have been merged.

SolninjaA avatar Apr 04 '25 05:04 SolninjaA

Thank you!

Nutomic avatar Apr 23 '25 13:04 Nutomic

Thanks very much for merging this commit (and also the UI one). I’m very happy to see that my work has been implemented into a project such as Lemmy.

There’s just two things I feel the need to mention. In my previous comment, I mentioned two considerations that ideally should be changed when the UI is merged and before the documentation PR is merged.

One of which is to update a placeholder to actually replace the Docker image tag in the Traefik configuration file with the latest version where this feature is available. It seems that this placeholder was merged, was this intended? If not, this should probably be changed.

Also, as I mentioned, the NGINX config hasn’t been tested. I was going to try testing it once the new Lemmy Docker version released, but I wasn’t entirely sure if it was available yet so I waited. Perhaps it could work with no problems, but conversely, it’s possible that it doesn’t work at all.

Are you fine with these considerations being left in the documentation, or would you like me to make a commit to fix the image tag, at the very least?

Thanks.

SolninjaA avatar Apr 23 '25 13:04 SolninjaA

These changes will be in the next version which will be 0.19.12, so you can already make a PR to change that. As for the nginx config you could add a simple note that it is untested.

Nutomic avatar Apr 23 '25 13:04 Nutomic

Thanks for that idea. I’ll try to get around to doing that, if someone hasn’t already. Sorry for the late reply - I’ve been quite busy.

Thanks!

SolninjaA avatar Apr 30 '25 12:04 SolninjaA