intocpsassociation/workspace repository overview

⁠DTaaS Workspace

A new workspace image for Digital Twin as a Service⁠.

We are still very much in the explorative phase. There may be breaking changes.

⁠Download Images

docker pull intocpsassociation/workspace:latest

⁠Run it

Either
Using plain docker command:

docker run -d --shm-size=512m \
  -p 8080:8080\
  -e MAIN_USER=dtaas-user --name workspace  workspace:latest

:point_right: You can change the MAIN_USER variable to any other username of your choice.

OR
using docker compose⁠:

docker compose -f compose.yml up -d

⁠Use Services

An active container provides the following services. Please remember to change dtaas-user to the username chosen in the previous command

• Open workspace - http://localhost:8080/dtaas-user/tools/vnc?path=dtaas-user%2Ftools%2Fvnc%2Fwebsockify⁠
• Open VSCode - http://localhost:8080/dtaas-user/tools/vscode⁠
• Open Jupyter Notebook - http://localhost:8080⁠
• Open Jupyter Lab - http://localhost:8080/dtaas-user/lab⁠

⁠Clean Up

Either
Using plain docker command:

docker stop workspace
docker rm workspace

Or using docker compose⁠:

docker compose -f compose.yml down

⁠Deployment Options

This workspace supports multiple deployment configurations depending on your needs:

⁠1. Standalone Development (Single User)

File: docker compose⁠
Use case: Local development, single user
Features: Basic workspace without reverse proxy
Documentation: See sections above

⁠2. Multi-User Development (HTTP)

File: compose.traefik.yml⁠
Use case: Multi-user development/testing without authentication
Features: Traefik reverse proxy, multiple workspaces
Documentation: TRAEFIK.md⁠

⁠3. Multi-User with OAuth2 (HTTP)

File: compose.traefik.secure.yml⁠
Use case: Development/testing with OAuth2 authentication
Features: Traefik reverse proxy, OAuth2 authentication, HTTP only
Documentation: TRAEFIK_TLS.md⁠

⁠4. Production Deployment (HTTPS + OAuth2)

File: compose.traefik.secure.tls.yml⁠
Use case: Production deployment with full security
Features: Traefik reverse proxy, OAuth2 authentication, TLS/HTTPS
Documentation: TRAEFIK_TLS.md⁠

Choose the configuration that best matches your deployment requirements.

⁠📊 Deployment Comparison