Deploy on Docker

MigratoryData Platform — Docker Deployment

A self-contained Docker Compose setup that runs MigratoryData Server (messaging plane), MigratoryData Portal (management plane), and Demo Publishers — sample services that continuously stream live data to the MigratoryData Server, providing ready-made subjects to explore and test the MigratoryData Portal.

Find the complete source code and configuration in the migratorydata-platform-sandbox repository on GitHub.

Directory Tree

docker/
├── docker-compose.yaml          # Service definitions for the full stack
├── run.sh                       # Pull images and start all services
├── stop.sh                      # Stop all running services
├── README.md                    # This file
├── data/
│   └── db/                      # Persistent SQLite database volume (portal)
├── migratorydata/
│   └── migratorydata.conf       # MigratoryData server configuration
└── migratorydata-portal/
    └── migratorydata-portal.conf # Portal configuration

Core Modules

migratorydata-server

The pub/sub messaging engine (migratorydata/server:6.0.24). Accepts WebSocket/HTTP connections from clients and delivers real-time messages to subscribers.

Configuration file: migratorydata/migratorydata.conf

migratorydata-portal

The API management portal (migratorydata/portal:1.0.4). Organizes subjects into streaming APIs, publishes them to the API Hub, and provides a self-service developer experience for adopting and testing APIs.

Configuration file: migratorydata-portal/migratorydata-portal.conf

Demo Publishers

Sample services that continuously stream live data to the MigratoryData Server, providing ready-made subjects to explore and test the MigratoryData Portal.

Prerequisites

• Docker Engine 20.10+
• Docker Compose v2 (bundled with Docker Desktop)

Verify your Docker installation:

docker --version
docker compose version

Setup Instructions

1. Clone the repository (if not already done)

git clone git@github.com:migratorydata/migratorydata-platform-sandbox.git
cd migratorydata-platform-sandbox/docker

2. (Optional) Review configuration files

Before starting, inspect and adjust configuration as needed:

# MigratoryData server
cat migratorydata/migratorydata.conf

# Portal
cat migratorydata-portal/migratorydata-portal.conf

3. Start the stack

To run in detached (background) mode:

docker compose up -d

4. Stop the stack

Stop and remove containers:

docker compose down

Getting Started

Open the Portal

Once the stack is running, open your browser and navigate to http://127.0.0.1:8080.

Log in with the default credentials:

Inspect Running Services

# List all running containers
docker compose ps

# Tail logs from the server
docker compose logs -f migratorydata-server

# Tail logs from the portal
docker compose logs -f migratorydata-portal

Network Architecture

All services communicate on an internal Docker bridge network (local-network). Only the following ports are published to the host: