1# Lemmy {#module-services-lemmy}
2
3Lemmy is a federated alternative to reddit in rust.
4
5## Quickstart {#module-services-lemmy-quickstart}
6
7the minimum to start lemmy is
8
9```nix
10{
11 services.lemmy = {
12 enable = true;
13 settings = {
14 hostname = "lemmy.union.rocks";
15 database.createLocally = true;
16 };
17 caddy.enable = true;
18 };
19}
20```
21
22this will start the backend on port 8536 and the frontend on port 1234.
23It will expose your instance with a caddy reverse proxy to the hostname you've provided.
24Postgres will be initialized on that same instance automatically.
25
26## Usage {#module-services-lemmy-usage}
27
28On first connection you will be asked to define an admin user.
29
30## Missing {#module-services-lemmy-missing}
31
32- Exposing with nginx is not implemented yet.
33- This has been tested using a local database with a unix socket connection. Using different database settings will likely require modifications