From c306ed17164be2d5e51b91bdbf824b78990e16af Mon Sep 17 00:00:00 2001 From: pedro Date: Mon, 18 Mar 2024 21:16:18 +0100 Subject: [PATCH] README: add localhost guide --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index 5a315fe..99ca3ee 100644 --- a/README.md +++ b/README.md @@ -57,6 +57,26 @@ - **nightly**: - Instance: https://idhub-nightly.demo.pangea.org - Motivation: regenerated on each day at 4:00 AM +- **localhost-pair**: + - Instances: + - http://localhost + - http://idhub2 + - Motivation: test locally an OIDC scenario +- **localhost-trio**: + - Instances: + - http://localhost + - http://idhub2 + - http://idhub3 + - Motivation: test locally a more complex OIDC scenario (similar to pilot no9b) + +### Details on localhost config + +You can test all the features in localhost. It was tested on Debian GNU/Linux 12 (bookworm) + +- on host machine install nginx and docker +- nginx acts as a reverse proxy is used to get into docker containers (same approach applies to deployed pilots and instances) + - see [nginx-localhost.site]() for the nginx site config +- add at the end of `/etc/hosts` a line with: `127.0.0.1 idhub2 idhub3` so you make work the DNS resolution locally ## Installation