DataSHIELD Workshop: Setting up the infrastructure

Author

Dick Postma and Xavier Escribà Montagut

Image 1 Image 2

Introduction

This site hosts materials for a hands‑on workshop on deploying and managing Opal and Armadillo. We will cover local deploy of the infrastructure, manage of profiles and profile creation. As extra material we will have a look at strategies of monitoring of the infrastructure. Expect practical Linux/SSH usage from a terminal and a copy‑pasteable flow you can follow on your laptop. The materials of this workshop, especially the live deploy part are applicable to cloud deployments as well.

Workshop Details

This workshop will be delivered at the DataSHIELD 2025 Conference hosted by the SIB Swiss Institute of Bioinformatics at the University of Lausanne (UniL), Switzerland, on Tuesday, September 23rd from 13:30 to 16:30 at room POL-338.

Getting started

Workshop scope

  • Deploy Opal and Armadillo with Docker Compose (no Kubernetes)
  • Nginx reverse proxy: go live with Let’s Encrypt
  • Basic Linux/SSH workflows suitable for on‑prem and cloud
  • Optional: lightweight monitoring with Telegraf/Prometheus + Grafana (time permitting)

Who this is for

  • Beginners to sysadmin tasks; we explain each step
  • Attendees on macOS (Apple Silicon ok), Windows (Docker Desktop/WSL2), or Linux
  • Follow‑along is encouraged but not mandatory

Prerequisites (summary)

See details in Environment Setup. In short:

  • Docker Desktop (Mac/Windows) or Docker Engine + Compose v2 (Linux)
  • Terminal + SSH access; ability to open ports 80/443 locally
  • Optional domain name if you want to test live certificates

Schedule

To be announced.

Credits

Materials developed by Dick Postma (Molgenis) and Xavier Escribà Montagut (BigOmics Analytics SA).

Contact

Dick Postma

f.d.postma at umcg.nl

Xavier Escribà Montagut

xavier.escriba.montagut at gmail.com