This guide walks you through the steps to set up and run your Midaz stack, with clear instructions for users of all technical backgrounds.

Prerequisites

Before starting, ensure the following tools and resources are ready on your machine:

1. System Requirements

• Operating System:
  • Windows: Windows 10 version 2004 and higher (Build 19041 and higher).
  • macOS: the current release of macOS and the previous two releases.
  • Linux: Ubuntu, Debian, Red Hat Enterprise Linux or Fedora
• RAM: At least 8 GB is recommended for running Docker.
• Disk Space: 20 GB of free storage for containers and data.
• Internet: A stable internet connection for downloading tools and dependencies.
• Browser: Use a modern browser like Google Chrome or Firefox for accessing services like Grafana.

2. Tools You Need

• Git: Installation Guide
• Docker Desktop: Installation Guide
• Postman (recommended): Download POSTMAN
• Chocolatey Package Manager: Installation Guide

3. Enable the make command

After installing Chocolatey, you must run the following command to install the make function:

sudo apt install make

brew install make

choco install make

Setting Up Midaz

Follow these steps to set up and run the Midaz stack:

1. Clone the Repository

1. Open a terminal or command prompt.
2. Clone the Midaz repository from GitHub and navigate to the project directory.
   1. Use the following command to clone the repository:

git clone https://github.com/LerianStudio/midaz.git
cd midaz

👍

Tip

If you're unsure how to use the terminal, refer to the Command Line Basics guide.

2. Configure the Environment Variables

Set up the required environment variables for Midaz by running this command:

make set-env

This step prepares your environment by setting up key configuration values that Midaz needs to operate correctly.

3. Start Midaz with Docker Compose

🚧

Attention

Make sure that Docker is running before running the command.

Start all the services for Midaz using the following command:

make up

This command builds and launches all the services defined in the docker-compose.yml file. The services will run in the background, allowing you to continue using the terminal.

4. Verify the Stack is Running

To ensure everything is working, check the status of running Docker containers:

docker ps  

You should see a list of active containers. If no containers are running, check for errors in the terminal output or consult the troubleshooting section below.

Next Steps

Once your Midaz project is set up, you can start using our APIs. To make this easier, we’ve made our API collection available on Postman. Here’s how to get started:

1. Navigate to the folder where you cloned the Midaz repository. The .json file for the Postman collection is located in the midaz\postman folder.

   • Alternatively, you can download the collection directly from GitHub.

2. Import the collection file into Postman. For guidance, refer to the Postman documentation.

3. Authenticate to Midaz by following the instructions on the Midaz Authentication page.

4. You’re all set to start exploring our endpoints.

👍

Ready to Build Your Midaz Structure?

Follow our Quick Start Guide to create your first Midaz Structure.

Need Help?

If you encounter any issues or want to get involved with the Midaz project, here are some resources:

1. Contribution Guidelines: Read our Contribution Guidelines to learn how to contribute effectively.
2. Join the Discussion: Connect with the community through our Discord channel. Discuss issues, share ideas, and learn from others.
3. Pick an Issue: Start contributing by selecting an open issue labeled for beginners or propose your own.

Don't hesitate to take the first step, whether new to open-source or an experienced contributor. For more detailed information, consult our Guides or reach out through our community support channels.