> ## 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, Ledger y Console incluidos, en solo unos comandos.

Midaz es un *Ledger* de código abierto diseñado para ser fácil de ejecutar, extender y probar localmente. Puedes instalarlo con solo unos pocos comandos usando **Docker Compose**, que configura el entorno completo (APIs backend y la consola legacy) de una sola vez.

Ya sea que estés construyendo algo nuevo o explorando cómo funciona Midaz internamente, esta guía te acompaña a través del proceso completo de configuración.

<Note>
  Midaz ahora se distribuye como un único repositorio. No necesitas instalar el Ledger y Console 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

***

Si estás usando 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>
  Si usas Windows, **ejecuta todos los comandos dentro de Ubuntu (WSL)**. ¿No estás familiarizado 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

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

### Paso 5 – Inicia los servicios

Asegúrate de que Docker esté ejecutándose, luego:

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

Todos los servicios, incluido el Console, se iniciarán.

### Paso 6 – Accede a tu entorno

* APIs de Ledger: [http://localhost:3000](http://localhost:3000/)
* Midaz Console: [http://localhost:8081](http://localhost:8081/) (antes de Midaz v3.5)

<Danger>
  Asegúrate de que Docker esté activo y todos los archivos .env estén configurados correctamente antes de abrir la consola.
</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, la versión comunitaria de Midaz es abierta y 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>
  Sin autenticación, recomendamos ejecutar Midaz 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 de código abierto, bajo la licencia [Elastic License 2.0](https://github.com/LerianStudio/midaz-console/blob/main/LICENSE.md).