designroom/dr-one repository overview

⁠Design Room ONE Docker image

Docker image for HCL Design Room ONE.

⁠Usage

The server exposes its Web UI via HTTPS port 10101 and Eclipse P2 repository for importer via HTTP port 10102, so those ports should to be exposed:

To run DR ONE server you will need a MongoDB instance available to it. It can be specified via environment variable DR_DB_URL or command line parameter --dr-db-url:

docker run -p 10101:10101 -p 10102:10102 -e DR_DB_URL=<MONGODB> designroom/dr-one

or

docker run -p 10101:10101 -p 10102:10102 designroom/dr-one node app.js --dr-db-url=<MONGODB>

where <MONGODB> is the address of your MongoDB instance, like mongodb://mongo.mycompany.com/dr.

⁠Using authentication with DR ONE

Design Room ONE can control access to published designs using Keycloak as an OpenID provider.

To start DR ONE container with authentication provided by a Keycloak server, use the following:

docker run -p 10102:10102 -p 10102:10102 -e DR_DB_URL=<MONGODB> \
    -e DR_AUTH=keycloak dr-one node app.js \
    --dr_keycloak_config:auth-server-url=<KEYCLOAK> \
    --dr_keycloak_config:realm=<REALM> \
    --dr_keycloak_config:resource=<CLIENT>

Here the <KEYCLOAK> is a Keycloak server URL, like https://keycloak.mycompany.com:8443/auth and the <REALM> and <CLIENT> are the realm and the client configured on that server, see Authentication Setup⁠ document for detailed instructions

⁠Using Docker Compose

To make deployment easier, you can use Docker Compose to start DR-ONE and its dependencies at once. You can use sample docker-compose.yaml and resources required by it available in the GitHub: https://github.com/hcl-pnp-rtist/dr-one-docker⁠.