Confused about which docker files to use during installation
Confused about which docker files to use during installation
I'm trying to set up a Lemmy instance using Docker on Ubuntu. This is my first time interacting with the open source community, so apologies if this is a stupid question. I'm not familiar with any common knowledge that might be obvious for people who frequently install software from github.
Anyway, in the official Lemmy installation guide, it says to download the following two files from the Lemmy github:
https://raw.githubusercontent.com/LemmyNet/lemmy/main/docker/docker-compose.yml https://raw.githubusercontent.com/LemmyNet/lemmy/main/docker/lemmy.hjson
However when you look at lemmy.hjson, it has a comment that says "This is a minimal lemmy config for the dev / main branch. Do not use for a release / stable version."
I'm a little confused because I would expect that the setup guide would want me to use the latest release version, not the dev version. Why is this not the case? If I'm not supposed to use the release version, then who is the release version intended for?
Anyways I tried looking for the latest release version branch, which appears to be 0.17, and I got confused again when I saw folders for "prod" and "federation" in the Docker folder. What's the difference?
Anyways can someone please help me understand the branch/folder structure? If I just want to run a regular Lemmy server with the latest stable code, which files should I use? Thanks
Maybe someone can give a better answer, but for me, I found the docker configs confusing and was having issues with them, so I just ignored them and used the ones from the Ansible repo: nginx and docker configs and app config
It required me to have nginx installed, but if you followed the let's encrypt Ubuntu guide, it has you install nginx
I had this exact same problem and ended up giving up and using the Ansible install method. It was way easier. Just make sure not to edit the hjson.config file at all before running it. All of the settings you will be able to change on the actual website once it's up and running.
Thanks, I'll try switching to the Ansible method. And thanks for the tip about the hjson.config.
No worries!
What registrar do you plan to use for your domain? Like example.com.
If you want to use Cloudflare, maybe I could make a guide on the selfhosted subs for what has worked for me.
I used Namecheap but I can switch to anything. I haven't heard of Cloudflare. How would switching to it affect the setup process?
It doesn't change much. I just have a dead-simple Caddy config that uses a Cloudflare API token to automate HTTPS certificate renewal. Much simpler than the nginx stuff they recommend.
But since I use Caddy instead of Nginx, I can't exactly give you my config if you wanted to use Nginx. The same thing I'm doing with Caddy can likely be done easily with Namecheap, but I'm too lazy to go and research that :p
To answer your original question, their docs are a bit lacking, and their Docker stuff seems to change every single time they do a release. Their config is also broken, I don't know how their lemmy.ml service functions with this config, but the docker-compose.yml they provide completely firewalls off federation, and pictrs can't reach the internet to download thumbnails.
If I have some time I might write up a guide to help the masses, but for now, maybe it will be a little easier if you use their stable files instead (still has the same issues I mentioned though):
I'm going to tweak my config to not require Cloudflare, then make a dead simple deploy script for everyone. I'll link you when it's done :)