Skip to content

Configuration Reference

This page describes each configuration file in this package. For the quick-start installation guide, see install.md.

config/.env

Source: config/.env.example

1
cp config/.env.example config/.env
Variable Example Description
DEFAULT_USER user1 Workspace path prefix and workspace folder name
COMPOSE_PROJECT_NAME dtaas Docker Compose project name

docker-compose.yml uses DEFAULT_USER in:

  • the router path prefix (/${DEFAULT_USER})
  • the workspace volume mount (./files/${DEFAULT_USER})
  • the MAIN_USER environment variable of the workspace container

config/client.js

Source: config/client.js.example

1
cp config/client.js.example config/client.js
Variable Example Description
REACT_APP_URL http://localhost Base URL of DTaaS
REACT_APP_CLIENT_ID (OAuth client id) Client OAuth application ID
REACT_APP_AUTH_AUTHORITY https://gitlab.com/ OAuth authority URL
REACT_APP_REDIRECT_URI http://localhost/Library Redirect URI after sign-in
REACT_APP_LOGOUT_REDIRECT_URI http://localhost/ Redirect URI after sign-out
LOGGER_URL http://localhost/logger URL of the logger service

files/

files/common is mounted read-write at /workspace/common.

Create a per-user workspace from files/template:

1
2
cp -R files/template files/<DEFAULT_USER>
sudo chown -R 1000:100 files/*

logs/logger/

The logger microservice writes the captured events to logs/logger/workflow-logs.jsonl. Create the directory and give it to uid 1000, the user that runs the logger:

1
2
mkdir -p logs/logger
sudo chown -R 1000:1000 logs/logger

Reload client config

After editing config/client.js, reload only the client service:

1
docker compose --env-file config/.env up -d --force-recreate client