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

# Instalar Midaz

> Instala Midaz de forma local con Docker Compose en unos pocos comandos: el entorno source-available completo, listo para el desarrollo local.

Midaz es un ledger source-available. Lo ejecutas, lo extiendes y lo pruebas de forma local. Instálalo con **Docker Compose**, que configura todo el entorno.

Esta guía te lleva por todo el proceso de configuración.

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

## Requisitos del sistema

***

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

## Herramientas que necesitas

***

* [Docker Desktop](https://docs.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 (por ejemplo, `apt`, `dnf`)

## ¿Usas 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 equipo si es necesario.
  </Step>

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

## Instala Midaz

***

### Paso 1 – Abre tu terminal

* **macOS/Linux:** usa tu aplicación de Terminal.
* **Windows:** abre Ubuntu mediante WSL.

<Danger>
  En Windows, **ejecuta todos los comandos dentro de Ubuntu (WSL)**. ¿Es tu primera vez 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="Ingresa a la carpeta">
    <CodeGroup>
      ```bash Bash theme={null}
      cd midaz
      ```
    </CodeGroup>
  </Step>
</Steps>

### Paso 4 – Configura las variables de entorno

Inicia Docker antes de este paso. `make set-env` copia los archivos `.env` y genera las claves `LCRYPTO_*` de CRM mediante un contenedor de Docker de un solo uso. El comando falla si Docker no está disponible.

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

### Paso 5 – Inicia los servicios

Verifica que Docker esté activo y luego ejecuta:

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

Se inician todos los servicios incluidos.

### Paso 6 – Accede a tu entorno

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

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

## Prueba la API

***

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

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

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

<Tip>
  Empieza con nuestra [guía de inicio rápido](/es/reference/products/midaz/quick-start-guide).
</Tip>

## Autenticación

***

De forma predeterminada, Midaz no requiere autenticación. Esto facilita las pruebas locales.

Si necesitas autenticación, usa el plugin [Access Manager](/es/platform/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.

Para contribuir, empieza con nuestra [guía de contribución](https://github.com/LerianStudio/midaz/blob/main/CONTRIBUTING.md).

<Tip>
  [Habla con nuestro equipo](https://lerian.studio/contact) para obtener soporte personalizado.
</Tip>

## Licencia

***

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