Skip to main content
Midaz es un ledger source-available. Lo ejecutas, extiendes y pruebas localmente. Instálalo con Docker Compose, que configura el entorno completo. Esta guía te acompaña por toda la configuración, ya sea que construyas algo nuevo o explores cómo funciona Midaz.
Midaz ahora se distribuye como un único repositorio. Ya no instalas sus servicios por separado.

​
Requisitos del sistema

​
Herramientas que necesitarás

​
¿En Windows? Instala WSL

En Windows, debes instalar WSL (Windows Subsystem for Linux) para ejecutar Midaz.
1
Abre PowerShell como administrador.
2
Ejecuta:
3
Reinicia tu máquina si es necesario.
4
Una vez instalado, abre la aplicación Ubuntu desde el Menú Inicio para continuar la configuración.

​
Instalar Midaz

​
Paso 1 – Abre tu terminal

  • macOS/Linux: Usa tu aplicación Terminal.
  • Windows: Abre Ubuntu vía WSL.
En Windows, ejecuta todos los comandos dentro de Ubuntu (WSL). ¿Nuevo con terminales? Consulta esta guía para principiantes.

​
Paso 2 – Instala make

  • Linux:
  • macOS:

​
Paso 3 – Descarga el repositorio de Midaz

1

Elige tu directorio de trabajo

2

Clona el repositorio

3

Entra en la carpeta

​
Paso 4 – Configura las variables de entorno

Docker ya debe estar corriendo: además de copiar los archivos .env, make set-env genera las claves LCRYPTO_* del CRM mediante un contenedor Docker de un solo uso y falla si Docker no está disponible.

​
Paso 5 – Inicia los servicios

Asegúrate de que Docker esté activo, luego:
Todos los servicios incluidos se inician.

​
Paso 6 – Accede a tu entorno

Asegúrate de que Docker esté activo y todos los archivos .env estén configurados antes de acceder a la API.

​
Prueba la API

¿Quieres explorar las APIs de Midaz?
1
Ve a midaz/postman.
2
Importa MIDAZ.postman_collection.json en Postman.
3
Explora los endpoints disponibles.
¿Listo para construir? Comienza con nuestra Guía de inicio rápido.

​
Autenticación

Por defecto, Midaz no requiere autenticación. Esto facilita las pruebas locales. Si necesitas autenticación, usa el plugin Access Manager, disponible para clientes empresariales.
Ejecuta Midaz sin autenticación solo en un entorno seguro y privado.

​
Comunidad y contribución

¿Quieres contribuir? Comienza con nuestra Guía de contribución.
¿Necesitas ayuda experta? Habla con nuestro equipo para soporte práctico.

​
Licencia

Midaz es source-available, bajo la Elastic License 2.0.