sdmxio/fmr repository overview

⁠About this image

This is the bare Fusion Metadata Registry deployment that requires a separate SQL database service for operation.

It's suitable for the following use cases:

• Production deployments
• Any other use cases where separation between the Fusion Metadata Registry service and the content storage is required

The sdmxio/fmr-mysql image is recommended for quick and simple deployment for personal use, ad hoc production use cases, capacity building, testing and evaluation.

⁠Prerequisites

⁠Mandatory

• 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)

⁠Optional

• 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⁠

⁠Quick start

⁠Docker Compose

Docker Compose scripts with various database integrations are available on the FMR public GitHub⁠.

⁠Bring your own database

Download the image and start a container called 'fmr'

docker run --name fmr -p 8080:8080 -eSERVER_URL=https://localhost:8080 sdmxio/fmr:latest

Navigate to http://localhost:8080/⁠

Complete the installation process by completing the forms, in particular:

• Configure the connection to an existing SQL database service (MySQL 5.7 and greater, SQL Sever or Oracle)
• Set the credentials for the 'root' superuser account

Installation process guidance⁠

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