Lemmy Service Configuration and Usage

nixos/modules/services/web-apps/lemmy.md

081c184e46db39a280a1f551c2b41fe68cc87d33a3ecff6d000000030000039b

# Lemmy {#module-services-lemmy}

Lemmy is a federated alternative to reddit in rust.

## Quickstart {#module-services-lemmy-quickstart}

the minimum to start lemmy is

```nix
{
  services.lemmy = {
    enable = true;
    settings = {
      hostname = "lemmy.union.rocks";
      database.createLocally = true;
    };
    caddy.enable = true;
  };
}
```

this will start the backend on port 8536 and the frontend on port 1234.
It will expose your instance with a caddy reverse proxy to the hostname you've provided.
Postgres will be initialized on that same instance automatically.

## Usage {#module-services-lemmy-usage}

On first connection you will be asked to define an admin user.

## Missing {#module-services-lemmy-missing}

- Exposing with nginx is not implemented yet.
- This has been tested using a local database with a unix socket connection. Using different database settings will likely require modifications

Chunks

074c8130 (1st chunk of `nixos/modules/services/web-apps/lemmy.md`)

Title: Lemmy Service Configuration and Usage

Summary

This document describes how to configure and use Lemmy, a federated Reddit alternative written in Rust. It provides a quickstart Nix configuration example to enable Lemmy, set a hostname, create a local PostgreSQL database, and expose the instance via a Caddy reverse proxy. Upon first connection, an admin user must be defined. The document also notes that Nginx exposure is not yet implemented and that using database settings other than a local Unix socket connection may require modifications.