A rambling list of notes to myself about hosting a Lemmy instance like this one
Basic Setup
Docker guide: https://lemmy.villa-straylight.social/post/1849#
However, I like the docker-compose.yml in the official docs better as a starting point. The docs pages aren't automatically published when a PR is merged, so refer to the Github Repo for the latest version.
This docker-compose.yml is mostly intended for development work, so you will need to replace the following lines:
build:
context: ../
dockerfile: docker/Dockerfile
with
image: dessalines/lemmy:0.17.4
Likewise, update the lemmy-ui image to dessalines/lemmy-ui:0.17.4.
I use basically the nginx.conf added by Just-Insane to the docker install page here.
Reverse Proxy
Lemmy uses websockets (for now anyway, that's changing soon) and websockets are kind of dumb. If you put this setup behind a reverse proxy, you need to make sure the reverse proxy properly handles web sockets. For nginx, this essentially means you need to copy the settings in the docker nginx.conf into your fronting reverse proxy.
Example:
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name lemmy.villa-straylight.social;
ssl_certificate /etc/letsencrypt/live/villa-straylight.social/fullchain.pem; # managed by Certbot
ssl_certificate_key /etc/letsencrypt/live/villa-straylight.social/privkey.pem; # managed by Certbot
include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
# frontend general requests
location / {
proxy_pass "http://localhost:[docker nginx port]";
rewrite ^(.+)/+$ $1 permanent;
# Send actual client IP upstream
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
# backend
location ~ ^/(api|pictrs|feeds|nodeinfo|.well-known) {
proxy_pass "http://localhost:[docker nginx port]";
# proxy common stuff
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
# Send actual client IP upstream
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Custom Themes
In docker-compose.yml, add a new volume to lemmy-ui, with /app/extra_themes as the path in the image. (Thanks to @[email protected] for pointing that out)
Example:
lemmy-ui:
image: dessalines/lemmy-ui:0.17.3
volumes:
- ./volumes/lemmy_themes:/app/extra_themes/
You can then drop .css files in there (e.g. a copy of one of the default themes) and they will appear as an option in the user's settings. The name of the theme is the file-name of the .css file.
