The contents below are for the DIY version of HollaEx Kit. For HollaCloud users, please visit the HollaEx Dashboard.

System Requirements (Single Host)

  • Debian-based Linux (Ubuntu), RHEL (CentOS), or macOS with Bash shell.
  • Minimum 2vCore CPU, 8GB RAM.
  • Minimum 50GB of Free Disk Space (SSD recommended).
  • Latest docker and docker-compose.
  • JSON Parser jq (download).
Make sure your system meets the requirements above otherwise, you might run into unexpected issues.
If you are using Debian based distribution (Ubuntu), CentOS, or RHEL with yum installed, docker, docker-compose and jq will all be installed automatically during the CLI's installation. Easy!

System Requirements (Kubernetes)

  • Client Computer
    • Debian-based Linux (Ubuntu), RHEL (CentOS), or macOS with Bash shell.
  • Host Kubernetes Server
    • Kubernetes v1.19 or Higher.
    • Recommended to have 3 worker nodes at least.
    • Recommended 2vCore CPU, 4GB RAM per worker node.
    • Recommended to have 30GB of Free Disk Space per node.
Make sure your system meets the requirements above, otherwise you might run into unexpected issues.


  • For Local Testing
    • Your computer, and that's it! 👨‍💻
  • For Production
📺 Watch on YouTube!: DIY Setup


You can download the Kit through Git from the HollaEx Kit GitHub repository. Clone the repository either directly through your web browser or by using the git command below:
git clone
HollaEx Kit is a full package with the necessary directory structure, templates, and even a full web server for a HollaEx Exchange.
Always keep the HollaEx Kit folder safe. It has all the information related to your exchange. You'll lose control of your exchange If you lose or damage the folder.


The first step is to install HollaEx CLI, a Command-Line tool that simplifies the operation of your HollaEx Kit. You should go into the HollaEx Kit path first to run any further commands.
cd hollaex-kit
Run the CLI installer by using the command below.
Starting from the HollaEx Kit version v1.0.3, the installer will automatically install docker, docker-compose, and jq if you don't have them already on your machine. The installer supports Debian-based distributions (apt-get), CentOS or RHEL (yum), and macOS (brew) partially.
Once the installation is completed, type hollaex version on your terminal to make sure HollaEx CLI is set correctly.
Once everything is done, it's time to set up your exchange!
Please proceed to the Setup section next.

HollaEx for Windows

HollaEx Kit is designed for Unix since most professional servers are running on a Unix-based system. However, don't worry! We understand that and this Windows guide is here to help.
Thanks to Microsoft, they recently released a cool technology called WSL 2 (Windows Subsystem for Linux 2), which allows Linux application works on native Windows.
Here we guide you on how to get started on your Windows Environment by using WSL 2 and Ubuntu.

Enabling WSL 2

You can follow this document by Microsoft to enable WSL 2 on your Windows PC.

Installing Ubuntu for WSL 2

You can download Ubuntu from the Microsoft Store after enabling WSL 2.


docker, docker-compose and jq will all be installed automatically by the installer so you do not need to install them manually.
One thing that will need to be done for docker to work correctly, is having the Windows Docker Desktop application. Without this, the server setup command later won't be able to complete.
All we need is for this app to be downloaded and open when we run hollaex server --setup, and we can actually see in the app the containers being made in real-time!
My Docker Desktop after running hollaex server -setup

Catching up with HollaEx

Once WSL 2 and Ubuntu are fully set on your computer, You can go back to our general document and proceed to get HollaEx Kit for your exchange.
Keep in mind that HollaEx on Windows is still only recommended for testing purposes. If you are considering building a production-ready exchange, please choose Linux.

HollaEx for macOS

HollaEx is compatible with the Unix environment. Since macOS is Unix compliant, there are no difficulties running HollaEx on macOS. But, the auto dependencies installer would not work for macOS. This page describes a way to install the required dependencies on your Mac.

Installing dependencies

The software mentioned below are dependencies that should be manually installed on your Mac.
  • Latest docker
  • Latest docker-compose
  • Homebrew (Package Management Software) - To install jq

Installing Docker

You can follow this document to install Docker and Docker compose on your Mac.
Once done with the installation, you need to increase the memory through Docker Preferences since Mac OS restricts memory usage.
Click the Docker menu in the top status bar and select Preferences.
Go to Resources and increase Memory to 8GB manually, and click the "Apply & Restart" button.

Installing jq with Homebrew

The most efficient way to install jq on a Mac would probably be using homebrew. Follow the simple step below to install brew on your Mac.
Open the Terminal application, and then enter the following command into a single line
ruby -e "$(curl -fsSL"
Enter the administrator password to begin installation (It will take a while depending on the speed of your Mac and internet connection). You will see the "Installation successful!" message once completed.
Start installing jqby typing the command below:
brew install jq