clearing up installation instructions

[nixoye]

clearing up installation instructions

[Nutomic]

Are you asking because there is some error or problem with your installation? Can you describe what exactly is going wrong?

[Tealk]

Hello,

which installation mode are you talking about?
You only need to adjust the nginx configuration if you deviate from the default configuration. Otherwise you can follow the installation instructions.

When I tried with LemmyBB I found that calls via the local address are more stable. In addition, a call via the domain does not work if the server is behind a NAT.

[nixoye]

The installation mode to install BB alongside an already active Lemmy instance

…

On Mon, Nov 28, 2022 at 4:13 AM, Tealk ***@***.***> wrote: Hello, which installation mode are you talking about? You only need to adjust the nginx configuration if you deviate from the default configuration. Otherwise you can follow the installation instructions. When I tried with LemmyBB I found that calls via the local address are more stable. In addition, a call via the domain does not work if the server is behind a NAT. — Reply to this email directly, [view it on GitHub](#69 (comment)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/ADAWMFXOUO4C4Y2CR3MJV2DWKRLTFANCNFSM6AAAAAASMJVBYM). You are receiving this because you authored the thread.Message ID: ***@***.***>

[nixoye]

Trying to install it and trying to be clear what sections i have to edit and what the edited version should look like

…

On Mon, Nov 28, 2022 at 8:32 AM, Nutomic ***@***.***> wrote: Are you asking because there is some error or problem with your installation? Can you describe what exactly is going wrong? — Reply to this email directly, [view it on GitHub](#69 (comment)), or [unsubscribe](https://github.com/notifications/unsubscribe-auth/ADAWMFWVUZS6WH4JCKEWZS3WKSJ6FANCNFSM6AAAAAASMJVBYM). You are receiving this because you authored the thread.Message ID: ***@***.***>

[Nutomic]

You also need to replace $lemmyui_domain with your actual domain for lemmyui (different from lemmybb domain, but can be a subdomain). Or you can remove that whole section to run without lemmyui, but note that lemmybb doesnt have any mod tools yet.

[nixoye]

ok here are some specific parts of the instructions I think is missing.

Copy the nginx config into the sites-enabled folder and edit it

cp docker/nginx.conf /etc/nginx/sites-enabled/lemmybb.conf

is missing the nano command to edit the lemmybb.conf

insert the following content and adapt 'LEMMYBB_BACKEND' and 'LEMMYBB_LISTEN_ADDRESS' to your installation`
what does adapting them to my installation mean? do i need to change the words `LEMMYBB_BACKEND` 

so instead of listing the ip and port number I'm supposed to put my domain name and port number? is this only if i changed something in the previous .conf file?

I'm unsure how I screwed up the installation, I'm probably gonna wipe the server and install lemmy and then lemmybb again from scratch. but heres the error i get now if i try to run the ansible

FAILED! => {"changed": true, "cmd": "nginx -s reload", "delta": "0:00:00.012663", "end": "2022-11-30 21:27:38.489940", "msg": "non-zero return code", "rc": 1, "start": "2022-11-30 21:27:38.477277", "stderr": "nginx: [emerg] unknown directive \"sdlimit_req_zone\" in /etc/nginx/sites-enabled/lemmybb.conf.save:1", "stderr_lines": ["nginx: [emerg] unknown directive \"sdlimit_req_zone\" in /etc/nginx/sites-enabled/lemmybb.conf.save:1"], "stdout": "", "stdout_lines": []}

[Tealk]

is missing the nano command to edit the lemmybb.conf

what if the user does not use Nano or it is not preinstalled on the device?
So it's just clear the file must be edited, use the tool you prefer to use, for many that is vim rather than nano

it says where the error is in the nginx config:
\"sdlimit_req_zone\" in /etc/nginx/sites-enabled/lemmybb.conf.save:1"]
so in the file lemmybb.conf.save in line 1

there you have specified a variable that is not defined anywhere sdlimit_req_zone
don't know where you got this, in the standard configuration you don't find this
https://github.com/LemmyNet/lemmyBB/blob/main/docker/nginx.conf

[nixoye]

@Nutomic

every step in the instructions is perfect and can be copy pasted one by one but then it breaks down in the last 3 steps.

Copy the nginx config into the sites-enabled folder and edit it

cp docker/nginx.conf /etc/nginx/sites-enabled/lemmybb.conf

there are no instructions on what to "edit" and no command to "edit" it. you use nano in the next command and its usually used so please include the nano command after it like

cp docker/nginx.conf /etc/nginx/sites-enabled/lemmybb.conf
nano /etc/nginx/sites-enabled/lemmybb.conf

and please add a code block with the .conf we can copy paste

the next step says adapt LEMMYBB_BACKEND' and 'LEMMYBB_LISTEN_ADDRESS to your installation I dont understand what "adapt 'LEMMYBB_BACKEND" means to my installation means. do i change those words to be my domain name? my sub domain name? can LEMMYBB_BACKEND and LEMMYBB_LISTEN_ADDRESS be replaced with something like "yoursubdomain.com"

[Tealk]

The two points you mentioned are not so easy to generalize, it's very system specific.
When creating the tutorial i assumed that the admin has basic knowledge of nginx and systemd.

and please add a code block with the .conf we can copy paste

This would not be a smart solution, if the configuration changes, you must always remember to also change the readme.

the next step says adapt LEMMYBB_BACKEND' and 'LEMMYBB_LISTEN_ADDRESS to your installation I dont understand what "adapt 'LEMMYBB_BACKEND" means to my installation means.

Also here I thought that an admin knows how to deal with variables.
I will think about how far you can adapt the instructions.

[nixoye]

@Tealk I used the ansible instructions to setup lemmy so im not sure what to "adapt" those sections to

[Nutomic]

Fixed in #75.