Platform Installer Guide

RDEL Health Services Platform

Institutional logo of RDEL Consulting and Advisory.

Note

Operational guide for installing and packaging Docker installers on Windows and macOS for the RDEL Health Services Platform.

1 Docker Installers for RDEL Health Services Platform

1.1 Quick Installation

This is the fastest way to run the platform with Docker Compose.

Recommended minimum requirements:

• Free disk space: 10 GB minimum recommended.
• Docker Desktop or Docker Engine with Docker Compose.

Docker download and installation (references as of March 6, 2026):

• Windows - Install Docker Desktop on Windows: https://docs.docker.com/desktop/setup/install/windows-install
• Windows - Direct download: https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe
• macOS - Install Docker Desktop on Mac: https://docs.docker.com/desktop/setup/install/mac-install
• macOS - Docker Desktop for Mac with Apple silicon: https://desktop.docker.com/mac/main/arm64/Docker.dmg
• macOS - Docker Desktop for Mac with Intel chip: https://desktop.docker.com/mac/main/amd64/Docker.dmg
• Linux - Install Docker Desktop on Linux: https://docs.docker.com/desktop/setup/install/linux
• Linux - Instructions and downloads for supported platforms (Ubuntu, Debian, Red Hat Enterprise Linux (RHEL), Fedora): https://docs.docker.com/desktop/setup/install/linux/#supported-platforms

Steps:

1. Download the zip file with the platform resources: https://www.rdel-cya.com/public/rdel-health-services-platform-1.0.0-a.zip
2. Extract rdel-health-services-platform-1.0.0-a.zip.
3. Open a terminal in the extracted folder rdel-health-services-platform-1.0.0-a:
   • Windows: in File Explorer, open the extracted folder, then right-click on empty space and select Open in Terminal.
   • macOS: open Terminal and use cd to the extracted folder (or right-click the folder and use New Terminal at Folder if available).
4. Enter the rdel-health-services-platform-1.0.0-a directory (where docker-compose.yml is located) and run the recommended command:

docker compose --env-file .env.production up -d --build

5. If you need a full rebuild without cache, run:

docker compose --env-file .env.production build --no-cache front back
docker compose --env-file .env.production up -d

1.2 Windows

1.2.1 Batch processing file .bat

File: installers/windows/install-rdel-plataforma-servicios-salud-docker.bat

What it does:

• Installs Docker Desktop with winget if not installed.
• Waits for Docker Engine to be ready.
• Verifies docker compose.
• Creates .env from .env.example if needed.
• Runs docker compose up -d --build.

Usage:

installers\windows\install-rdel-plataforma-servicios-salud-docker.bat

1.2.2 Microsoft Installer file .msi

WiX project to generate MSI:

• installers/windows/msi/Product.wxs
• installers/windows/msi/install-rdel-plataforma-servicios-salud-docker-prereqs.bat
• installers/windows/msi/build-msi.ps1

Build (on Windows, with WiX installed):

powershell -ExecutionPolicy Bypass -File installers\windows\msi\build-msi.ps1

Expected output:

• installers/windows/dist/rdel-plataforma-servicios-salud-docker-installer.msi

1.3 macOS

1.3.1 Executable script .command

File: installers/macos/install-rdel-plataforma-servicios-salud-docker.command

What it does:

• Installs Docker Desktop with Homebrew Cask if not installed.
• Starts Docker Desktop and waits for availability.
• Verifies docker compose.
• Creates .env from .env.example if needed.
• Runs docker compose up -d --build.

Usage:

./installers/macos/install-rdel-plataforma-servicios-salud-docker.command

1.3.2 Disk image file .dmg

1.3.3 Generate DMG

Script: installers/macos/create-installer-dmg.sh

This script (run on macOS) packages:

• install-rdel-plataforma-servicios-salud-docker.command
• README.txt

Command:

./installers/macos/create-installer-dmg.sh

Expected output:

• installers/macos/rdel-plataforma-servicios-salud-docker-installer-macos.dmg