> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalando Midaz

> Instala Midaz localmente con Docker Compose — el entorno completo, en solo unos comandos.

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.

<Note>
  Midaz ahora se distribuye como un único repositorio. Ya no instalas sus servicios por separado.
</Note>

## Requisitos del sistema

***

| Requisito             | Mínimo                                                                                                                                                                                 |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sistema operativo** | - **Windows**: Windows 10 **vía WSL** versión 2004 o posterior (Build 19041+) <br /> - **macOS**: Versión actual o las dos anteriores <br /> - **Linux**: Ubuntu o Debian recomendados |
| **RAM**               | 8 GB                                                                                                                                                                                   |
| **Espacio en disco**  | 20 GB                                                                                                                                                                                  |
| **Internet**          | Conexión estable                                                                                                                                                                       |
| **Navegador**         | Chrome, Firefox o equivalente                                                                                                                                                          |

## Herramientas que necesitarás

***

* [Docker Desktop](https://www.docker.com/get-docker/)
* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
* [Postman](https://www.postman.com/downloads/) (opcional)
* Gestor de paquetes:
  * macOS: [Homebrew](https://brew.sh/)
  * Linux: Usa el gestor de paquetes de tu sistema (ej., `apt`, `dnf`)

## ¿En Windows? Instala WSL

***

En Windows, debes instalar WSL (Windows Subsystem for Linux) para ejecutar Midaz.

<Steps>
  <Step>
    Abre PowerShell como administrador.
  </Step>

  <Step>
    Ejecuta:

    <CodeGroup>
      ```bash Text theme={null}
      wsl --install
      ```
    </CodeGroup>
  </Step>

  <Step>
    Reinicia tu máquina si es necesario.
  </Step>

  <Step>
    Una vez instalado, abre la aplicación Ubuntu desde el Menú Inicio para continuar la configuración.
  </Step>
</Steps>

## Instalar Midaz

***

### Paso 1 – Abre tu terminal

* **macOS/Linux:** Usa tu aplicación Terminal.
* **Windows:** Abre Ubuntu vía WSL.

<Danger>
  En Windows, **ejecuta todos los comandos dentro de Ubuntu (WSL)**. ¿Nuevo con terminales? Consulta [esta guía para principiantes](https://www.codecademy.com/learn/learn-the-command-line).
</Danger>

### Paso 2 – Instala `make`

* **Linux:**

  <CodeGroup>
    ```bash Text theme={null}
    sudo apt install make
    ```
  </CodeGroup>
* **macOS:**

  <CodeGroup>
    ```bash Text theme={null}
    brew install make
    ```
  </CodeGroup>

### Paso 3 – Descarga el repositorio de Midaz

<Steps>
  <Step title="Elige tu directorio de trabajo">
    <CodeGroup>
      ```bash Text theme={null}
      cd ~/Desktop
      ```
    </CodeGroup>
  </Step>

  <Step title="Clona el repositorio">
    <CodeGroup>
      ```bash Text theme={null}
      git clone https://github.com/LerianStudio/midaz.git
      ```
    </CodeGroup>
  </Step>

  <Step title="Entra en la carpeta">
    <CodeGroup>
      ```bash Bash theme={null}
      cd midaz
      ```
    </CodeGroup>
  </Step>
</Steps>

### 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.

<CodeGroup>
  ```bash Bash theme={null}
  make set-env
  ```
</CodeGroup>

### Paso 5 – Inicia los servicios

Asegúrate de que Docker esté activo, luego:

<CodeGroup>
  ```bash Bash theme={null}
  make up
  ```
</CodeGroup>

Todos los servicios incluidos se inician.

### Paso 6 – Accede a tu entorno

* API de Ledger: [http://localhost:3002](http://localhost:3002/)

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

## Prueba la API

***

¿Quieres explorar las APIs de Midaz?

<Steps>
  <Step>
    Ve a `midaz/postman`.
  </Step>

  <Step>
    Importa `MIDAZ.postman_collection.json` en Postman.
  </Step>

  <Step>
    Explora los endpoints disponibles.
  </Step>
</Steps>

<Tip>
  ¿Listo para construir? Comienza con nuestra [Guía de inicio rápido](/es/reference/quick-start-guide).
</Tip>

## Autenticación

***

Por defecto, Midaz no requiere autenticación. Esto facilita las pruebas locales.

Si necesitas autenticación, usa el plugin [Access Manager](/es/platform/access-manager/access-manager), disponible para clientes empresariales.

<Danger>
  Ejecuta Midaz sin autenticación solo en un entorno seguro y privado.
</Danger>

## Comunidad y contribución

***

* Únete a nosotros en [Discord](https://discord.com/invite/DnhqKwkGv3).
* Reporta problemas en [GitHub](https://github.com/LerianStudio/midaz).
* Sigue a [@LerianStudio](https://twitter.com/LerianStudio) en Twitter.

¿Quieres contribuir? Comienza con nuestra [Guía de contribución](https://github.com/LerianStudio/midaz/blob/main/CONTRIBUTING.md).

<Tip>
  ¿Necesitas ayuda experta? [Habla con nuestro equipo](https://lerian.studio/contact) para soporte práctico.
</Tip>

## Licencia

***

Midaz es source-available, bajo la [Elastic License 2.0](https://github.com/LerianStudio/midaz/blob/main/LICENSE).