sdmxio/fmr-mysql repository overview

⁠About this image

This is the single-image Fusion Metadata Registry deployment incorporating an embedded MySQL database. It's suitable for the following use cases:

• Light ad hoc production workloads
• Personal use, e.g. desktop data modelling, data validation and mapping
• Capacity building exercises
• Testing and evaluation

The sdmxio/fmr image is recommended for most production deployments.

⁠Prerequisites

⁠Mandatory

• (none)

⁠Optional

• A separate SQL database service prepared with a dedicated schema that FMR will use to persist the metadata content (MySQL 5.7 or greater, SQL Server or Oracle)
• Directory service (Active Directory or LDAP)

⁠Fusion Metadata Registry for SDMX

⁠Fusion Metadata Registry is a free to use SDMX structural metadata registry, data modelling platform and data processing engine for official statistics producers, collectors and reporters.

⁠Version 11 support

• SDMX 2.0, 2,1 and 3.0
• SDMX-ML (XML) 2.0, 2.1 and 3.0 data and structure transmission formats
• SDMX-JSON versions 1 and 2 data and structure transmission formats
• SDMX-CSV versions 1 and 2 data and structure transmission formats

⁠Version 12 adds

• Semantic versioning
• Metadata time travel
• OIDC / SSO authentication
• Big metadata support through improved memory management
• Content migration from FMR 11

Find out more on sdmx.io⁠

⁠Where to use this image

This is a self-contained Fusion Metadata Registry image complete with a MySQL database suitable for testing, personal use and light production work loads.

⁠10 minute quick start

Download the image and start a container called 'fmr'

docker run --name fmr -p 8080:8080 sdmxio/fmr-mysql:latest

Point your browser at http://localhost:8080/⁠

The container will take between 1 and 2 minutes to start - so please be patient!

There is a single Root User Account:
Username: root
Password: password

Log in to administer the system, and create, load and maintain SDMX structures.

When finished, stop the container

docker stop fmr

⁠Changing the Server URL

By default, the image assumes the service will be published on http://localhost:8080⁠. If you need to deploy on a different host and port, set the SERVER_URL environment variable when creating the container.

In the following example, the service will be published on https://fmr.mydomain.org:8080⁠.

docker container create --name fmr11 --publish 8080:8080 -eSERVER_URL=https://fmr.mydomain.org:8080 sdmxio/fmr-mysql:latest

⁠What does Fusion Metadata Registry do?

1. Metadata Registry – controlled repository for SDMX structural metadata - acts as a single source of truth for: automated metadata-driven data processing systems, publishing the metadata needed by data providers in data collection use cases, or publishing structures for the purposes of standardisation, statistical data harmonisation, and communal benefit. Implements the SDMX Registry specification.
2. Data Processing Services – provides three integrated metadata-driven data processing services: data validation, data transformation (mapping data from one structure to another) and conversion of data between SDMX data transmission formats. The services can be used interactively through the web UI, or integrated into data automation processes using the REST API.
3. Metadata authoring and maintenance – interactive web user interface to assist metadata managers in the task of browsing, authoring and maintaining their structural metadata model.
4. Data modelling - interactively model data domains using the SDMX metamodel.

⁠Troubleshooting

If the container fails to start or terminates under load when running on Windows, it is likely that insufficient memory resources have been allocated. Open Docker Settings and look for Advanced under Resources. In some circumstances, Docker puts a limit of 2GB on memory which is insufficient. Increase memory to a minimum of 4GB. There's more on configuring Docker Desktop for Windows in the Docker documentation⁠.

Other questions, contact us at [email protected]⁠ . Or ask the community on the SDMX User Forum⁠

⁠More about Fusion Metadata Registry

Fusion Metadata Registry is part of the sdmx.io ecosystem of open source software tools for SDMX and official statistics.
There's more about Fusion Metadata Registry on the sdmx.io website⁠.

FMR Wiki and documentation⁠

⁠License

Web application: Public License Agreement
Source code: Apache 2.0
License Agreement⁠
Copyright Bank for International Settlements 2025 all rights reserved.

By using the software you agree to the license terms.

⁠BIS Open Tech

Fusion Metadata Registry is published under BIS Open Tech⁠, a platform for sharing statistical and financial software as public goods, by promoting international cooperation and coordination. These software tools are developed according to international best practices and standards and can be reused and further developed in a wide variety of environments