From 5146ba1792093283632b285560785e07296b1345 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 26 Jan 2026 19:41:12 +0000 Subject: [PATCH 1/3] Initial plan From f083641c06d3fbbb9d8a038666dbf03d87d5033a Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 26 Jan 2026 19:43:27 +0000 Subject: [PATCH 2/3] Document LYO_BASEURL environment variable and add examples to docker-compose files Co-authored-by: berezovskyi <64734+berezovskyi@users.noreply.github.com> --- README.md | 28 ++++++++++++++++++++++++++++ src/docker-compose.tomcat.yml | 12 ++++++++++++ src/docker-compose.yml | 12 ++++++++++++ 3 files changed, 52 insertions(+) diff --git a/README.md b/README.md index 97eea468..1ba1a0cd 100644 --- a/README.md +++ b/README.md @@ -161,6 +161,34 @@ After that, OSLC servers are available at the following URLs: - http://localhost:8802/services/catalog/singleton - http://localhost:8803/services/catalog/singleton +### Configuring Base URLs + +By default, the servers use `http://localhost:8080` as the base URL. You can override this using the `LYO_BASEURL` environment variable to configure the public-facing URL for each server. This is particularly useful when: +- Running behind a reverse proxy +- Deploying to a cloud environment with a custom domain +- Using non-standard ports or HTTPS + +**Examples:** + +For a reverse proxy deployment where the RM server is accessible at `https://mytoolchain.example.com:9443/refimpl/rm/`: +```bash +export LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/rm/ +``` + +When using Docker Compose, set environment variables for each service: +```yaml +services: + server-rm: + environment: + - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/rm/ +``` + +See the commented examples in `docker-compose.yml` for more details. + +**Note:** The servlet path (e.g., `/services/`) is automatically appended to the base URL, so you should only specify the base path up to but not including `/services/`. + +### OAuth Configuration + Currently, OAuth 1.0 with Basic fallback is enabled only on the OSLC RM server (port 8800). Use `admin:admin` credentials for Basic authentication. In order to enable OAuth support on other servers, uncomment the following lines under `src/main/webapp/WEB-INF/web.xml` of each server: ```xml diff --git a/src/docker-compose.tomcat.yml b/src/docker-compose.tomcat.yml index 74404077..717949c1 100644 --- a/src/docker-compose.tomcat.yml +++ b/src/docker-compose.tomcat.yml @@ -5,21 +5,33 @@ services: dockerfile: ./server-rm/tomcat.Dockerfile ports: - "8800:8080" + # Uncomment to configure the base URL for reverse proxy or custom domain deployments + # environment: + # - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/rm server-cm: build: context: ./ dockerfile: ./server-cm/tomcat.Dockerfile ports: - "8801:8080" + # Uncomment to configure the base URL for reverse proxy or custom domain deployments + # environment: + # - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/cm server-qm: build: context: ./ dockerfile: ./server-qm/tomcat.Dockerfile ports: - "8802:8080" + # Uncomment to configure the base URL for reverse proxy or custom domain deployments + # environment: + # - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/qm server-am: build: context: ./ dockerfile: ./server-am/tomcat.Dockerfile ports: - "8803:8080" + # Uncomment to configure the base URL for reverse proxy or custom domain deployments + # environment: + # - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/am diff --git a/src/docker-compose.yml b/src/docker-compose.yml index 86c9054a..98f08f48 100644 --- a/src/docker-compose.yml +++ b/src/docker-compose.yml @@ -5,21 +5,33 @@ services: dockerfile: server-rm/Dockerfile ports: - "127.0.0.1:8800:8080" + # Uncomment to configure the base URL for reverse proxy or custom domain deployments + # environment: + # - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/rm server-cm: build: context: ./ dockerfile: server-cm/Dockerfile ports: - "127.0.0.1:8801:8080" + # Uncomment to configure the base URL for reverse proxy or custom domain deployments + # environment: + # - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/cm server-qm: build: context: ./ dockerfile: server-qm/Dockerfile ports: - "127.0.0.1:8802:8080" + # Uncomment to configure the base URL for reverse proxy or custom domain deployments + # environment: + # - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/qm server-am: build: context: ./ dockerfile: server-am/Dockerfile ports: - "127.0.0.1:8803:8080" + # Uncomment to configure the base URL for reverse proxy or custom domain deployments + # environment: + # - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/am From eeda5591a2aaf2e6966e8553dfa82b6d70017197 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 26 Jan 2026 19:44:30 +0000 Subject: [PATCH 3/3] Fix trailing slashes in LYO_BASEURL examples to match documentation guidance Co-authored-by: berezovskyi <64734+berezovskyi@users.noreply.github.com> --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1ba1a0cd..1e522bd3 100644 --- a/README.md +++ b/README.md @@ -172,7 +172,7 @@ By default, the servers use `http://localhost:8080` as the base URL. You can ove For a reverse proxy deployment where the RM server is accessible at `https://mytoolchain.example.com:9443/refimpl/rm/`: ```bash -export LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/rm/ +export LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/rm ``` When using Docker Compose, set environment variables for each service: @@ -180,7 +180,7 @@ When using Docker Compose, set environment variables for each service: services: server-rm: environment: - - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/rm/ + - LYO_BASEURL=https://mytoolchain.example.com:9443/refimpl/rm ``` See the commented examples in `docker-compose.yml` for more details.