From 8bc361ee7c47676858d0f4e9590dc7dd47e089f7 Mon Sep 17 00:00:00 2001 From: MaxJa4 <74194322+MaxJa4@users.noreply.github.com> Date: Fri, 11 Mar 2022 10:16:55 +0100 Subject: [PATCH 1/3] Updated dependencies of manual setup - apt install of nodejs installs an unsupported (V10.X) version - dependencies for python-ldap were missing --- docs/install/manual.md | 26 ++++++++++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/docs/install/manual.md b/docs/install/manual.md index e37334dd..6ebadcf9 100644 --- a/docs/install/manual.md +++ b/docs/install/manual.md @@ -19,9 +19,25 @@ Give the user permissions: `chown -R recipes:www-data /var/www/recipes` Create virtual env: `python3.9 -m venv /var/www/recipes` -Install Javascript Tools +Install Javascript Tools (nodejs >= 12 required) +```shell +### Just use one of these possibilites! +# Using Ubuntu +curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - +sudo apt-get install -y nodejs + +# Using Debian, as root +curl -fsSL https://deb.nodesource.com/setup_lts.x | bash - +apt-get install -y nodejs + +# Using a RPM based distro +## ... as root +curl -fsSL https://rpm.nodesource.com/setup_lts.x | bash - + +## ... no root privileges +curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash - +``` ```shell -sudo apt install nodejs sudo npm install --global yarn ``` @@ -31,6 +47,12 @@ sudo npm install --global yarn sudo apt install libpq-dev postgresql ``` +### Install LDAP requirements + +```shell +sudo apt install libsasl2-dev python-dev libldap2-dev libssl-dev +``` + ###Install project requirements !!! warning "Update" From 34f70e4ba7aef7c0f64a421cab0ba75910b74bf5 Mon Sep 17 00:00:00 2001 From: MaxJa4 <74194322+MaxJa4@users.noreply.github.com> Date: Fri, 11 Mar 2022 10:18:51 +0100 Subject: [PATCH 2/3] Fixed formatting --- docs/install/manual.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/manual.md b/docs/install/manual.md index 6ebadcf9..2a7bdb08 100644 --- a/docs/install/manual.md +++ b/docs/install/manual.md @@ -53,7 +53,7 @@ sudo apt install libpq-dev postgresql sudo apt install libsasl2-dev python-dev libldap2-dev libssl-dev ``` -###Install project requirements +### Install project requirements !!! warning "Update" Dependencies change with most updates so the following steps need to be re-run with every update or else the application might stop working. From 36fbbed1b0321f27e6b2fb048c4afb22805b6477 Mon Sep 17 00:00:00 2001 From: MaxJa4 <74194322+MaxJa4@users.noreply.github.com> Date: Fri, 11 Mar 2022 10:21:50 +0100 Subject: [PATCH 3/3] Added link to docs of nodejs installation --- docs/install/manual.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/install/manual.md b/docs/install/manual.md index 2a7bdb08..3d6231dc 100644 --- a/docs/install/manual.md +++ b/docs/install/manual.md @@ -41,6 +41,9 @@ curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash - sudo npm install --global yarn ``` +!!! info "NodeJS installation issues" + If you run into problems with the NodeJS installation, please refer to the [official documentation](https://github.com/nodesource/distributions/blob/master/README.md). + ### Install postgresql requirements ```shell