Docker Desktop setup

Use Docker Desktop when validating the full laboratory or radiology workflow. The local override publishes services on loopback and mounts selected integration files for rapid iteration.

Local endpoints

Service	Address
HMIS	`http://localhost:8080`
OIE HTTP administration	`http://localhost:8081`
OIE HTTPS administration	`https://localhost:8443`
Orthanc Explorer	`http://localhost:8042`
OHIF viewer	`http://localhost:3000`
Mock analyzer	`http://localhost:8090`
Mock modality	`http://localhost:8091`

Create the local environment file

Copy-Item .env.example .env

Set non-empty local-only values for these required Compose variables:

APP_KEY={{LOCAL_APP_KEY}}
DB_DATABASE=hmis_local
DB_USERNAME=hmis_local
DB_PASSWORD={{LOCAL_HMIS_DB_PASSWORD}}
OIE_DB_PASSWORD={{LOCAL_OIE_DB_PASSWORD}}
OIE_KEYSTORE_STOREPASS={{LOCAL_OIE_STORE_PASSWORD}}
OIE_KEYSTORE_KEYPASS={{LOCAL_OIE_KEY_PASSWORD}}
ORTHANC_DB_PASSWORD={{LOCAL_ORTHANC_DB_PASSWORD}}

Render the Compose configuration

Validate interpolation before creating containers:

docker compose -f docker-compose.yml -f docker-compose.local.yml config --quiet

Build and start the stack

docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --build

Run migrations and development seeding

docker compose exec app php artisan migrate --force
docker compose exec app php artisan db:seed --force

The broad seeder is permitted here only because this is a disposable local environment.

Check service state

docker compose -f docker-compose.yml -f docker-compose.local.yml ps
docker compose exec app php artisan about --only=environment
docker compose exec app php artisan schedule:list

Apply source changes

The local override mounts selected integration files, not the entire application. Rebuild app, queue, and scheduler when other PHP or frontend files change:

docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --build app queue scheduler

Stop or remove the stack

Stop containers while preserving data:

docker compose -f docker-compose.yml -f docker-compose.local.yml down

The following command permanently deletes all local HMIS, OIE, and Orthanc volumes. Confirm that the Compose project contains no required data before running it.

docker compose -f docker-compose.yml -f docker-compose.local.yml down --volumes

Local-only security boundary

The local override binds administration, PACS, DICOM, and simulator endpoints to 127.0.0.1. Do not change these bindings to 0.0.0.0 on a shared network. The demonstration Orthanc configuration does not provide production authentication controls. Continue with the laboratory integration or radiology integration guides.

Getting started

Local development

Dokploy deployment

Initial configuration

Integrations

Operations

Local endpoints

Apply source changes

Stop or remove the stack

Local-only security boundary

​Local endpoints

​Apply source changes

​Stop or remove the stack

​Local-only security boundary

Local endpoints

Apply source changes

Stop or remove the stack

Local-only security boundary