From e84ebaee7a8f09c2c045b0c02c6980f38b5579c3 Mon Sep 17 00:00:00 2001 From: barnold Date: Sun, 16 Oct 2022 09:39:38 +0100 Subject: [PATCH] INSTALL wip --- INSTALL | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ README | 7 +++---- 2 files changed, 61 insertions(+), 4 deletions(-) create mode 100644 INSTALL diff --git a/INSTALL b/INSTALL new file mode 100644 index 0000000..9e5a35c --- /dev/null +++ b/INSTALL @@ -0,0 +1,58 @@ +There are numerous ways of deploying a Mojolicious app, so this +is just one way. + +0. Dependencies + +pgc-db + +1. Create a user to run the perl process. + + # adduser --no-create-home --home-dir /var/www \ + --shell /usr/sbin/nologin --disabled-login pgc-www + +2. Configure postgres. + +Create a postgres user for pgc-www. + + # su - postgres + ## Add a user with readonly access to the tables, named as you like. + $ createuser --connection-limit=10 --role=pgc_user pgc-www + +If you're using the simplest case, 'peer' authentication, then add a +line in pg_ident.conf into the map you used for pgc-db. + + # MAPNAME SYSTEM-USERNAME PG-USERNAME + ... ... ... + irulanmap pgc-www pgc-www + +Tell postgres about your edit. + + # systemctl reload postgres + +At this point, pgc-www should have access to the database. Test with + + # sudo -u pgc-www psql pg_book_catalog + +3. Install the source code. + + # cd /opt + # git clone https://tildegit.org/barnold/pgc-www.git + +At this point, the user 'pgc-www' should be able to run the app. Test with + + # sudo -u pgc-www morbo /opt/pgc-www/script/my_app + +and visit in your browser. + +4. Optionally, provide your email address to site visitors. + +Add /opt/pgc-www/local-override.yml containing e.g. + + email-address: webmaster@example.net?Subject=Love your site! + email-name: webmaster@example.net + +After you restart the app, your address should appear on the 'about' page. + +5. ... + + \ No newline at end of file diff --git a/README b/README index 3add39f..25b0f1c 100644 --- a/README +++ b/README @@ -1,9 +1,9 @@ ABOUT This is a Mojolicious web site app for looking through the catalog -provided by Project Gutenberg . It uses -the database and perl modules provided by -. +provided by Project Gutenberg . It has no +affiliation with Project Gutenberg, it just gratefully uses the +catalog they provide. COPYING @@ -12,4 +12,3 @@ Public License, version 3 . Comments are welcome at . -