HollaEx®
⚙️ DashboardStart →
  • HollaEx® — The Crypto Exchange Solution
  • ☁️Cloud Operators
    • Launching the Exchange
    • Setting Domain for Cloud Exchanges
    • Easy SMTP for Cloud Exchanges
    • SEO Settings for Cloud Exchanges
      • SEO Advanced Settings
  • ⚙️Operating Your Exchange
    • Operator Control Panel
      • General
      • Users
      • User Profile
      • Assets
      • Markets
      • Stakes
      • Sessions
      • Plugins Apps
      • Trading Fees & Account Tiers
      • Roles
      • Chat
      • Billing
    • Customize Exchange
      • Browser Tools
        • Enter Edit Mode
        • Operator Controls (Visuals)
        • Console
      • Plugins
      • Forked Repo
    • Fiat Controls
      • Initial Setup
      • Setting Up Fiat On/ Off Ramp
      • Editing Deposit & Withdrawal Fees
      • Users Making Fiat Deposit
      • Users Trading With Fiat
      • User Making Fiat Withdrawal
    • Staking
    • OTC Broker
    • P2P
      • P2P Overview
      • P2P Setup
      • P2P Troubleshooting
      • P2P Vendor Flow
    • Smart Chain Trading
    • Assets & Trading Pairs
      • Add New Assets & Trading Pairs
      • Configure Pair Parameters
    • Set up the SMTP Email
      • Set up SMTP with AWS SES
      • Set up SMTP with Mailgun
      • Set up SMTP with SendGrid
      • Test the SMTP with Gmail
    • Enabling reCAPTCHA
    • Email Customization & Audit
    • DeFi Asset Staking Process
  • 🧩Plugins
    • HollaEx Plugins
      • Announcements
      • Bank
      • AWS SNS (Text Messages - SMS)
      • KYC
      • Automatic KYC
      • Messente
      • Advanced Referral
      • CoinMarketCap
      • Guardarian
    • Install Plugins
    • Developing Plugins
      • Development Walkthrough: Hello-Plugin
        • Initialization
        • Configuration
        • Scripting
        • Web View
        • The Final Product & Installation
      • Advanced
        • Initialization
        • Config
        • Server Script
        • Plugin Libraries
        • Web View
        • Final Plugin Product
        • Advanced Tutorial: Using the user meta field
        • Advanced Tutorial: Adding a new database table column
        • Advanced Tutorial: Creating a new database table
      • Simple Wallet Example
      • Web View Development
        • Overview
        • External dependencies
        • Getting started
        • Basic Tutorial: Hello Exchange Plugin web view
        • Advanced Tutorial: KYC Plugin web views
    • Bank Integration
      • Handling Deposits
      • Handling Withdrawals
  • 👷Developers
    • API Guide
      • API Example Scripts
    • Run Dev Mode
    • Build a New Front-end Interface
  • 🧰On-Premise Operators (Advanced Only)
    • On-Premise Exchange Setup
      • Getting Started — Requirements
      • Installation
      • Server Setup
      • Web Setup
      • Production
    • CLI How-Tos
      • Start Exchange
      • Stop Exchange
      • Upgrade Exchange
        • Build and Apply the Code Changes
      • Get Exchange Logs
      • Get a Backup and Restore
      • Exchange Migration
      • Command List
    • Run Exchange on Kubernetes
    • Troubleshooting Guide
  • 🚀Advanced
    • SEO Optimization
    • Nginx
    • Rate Limits
    • Database
      • Upgrade Database
    • Dependencies
    • Contents Delivery Network
      • Cloudflare CDN for HollaEx
      • CloudFront CDN for HollaEx
    • Load Balancer
      • AWS ELB
      • DigitalOcean LB
    • Customize Kubenretes Ingress
    • Exchange Keys
      • Exchange API Keys Troubleshoot
    • HollaEx on non-Linux
      • HollaEx on Windows
      • HollaEx on macOS
    • The Network Tool Library
      • Accessing the Network Tool Library
      • Functions
        • WebSocket
      • Simple Example: Creating a User and Wallet
      • Getting More Interesting: Orders with the Tools
        • Setup: Using the transferAsset function
        • Creating and Monitoring a Sell Order
        • Settling Fees
      • Private HollaEx Network
    • Docker Content Trust (DCT)
    • Revenue Sharing
  • 📦Releases
    • Release Notes
    • Side Notes
  • ➡️External Links
  • Blogs
  • Forum
  • Videos
  • Twitter X
  • Telegram
  • Interactive Demo
  • Discord Community
  • API Documentation
  • Tools Library Documentation
  • Node Library Documentation
  • Plugins Documentation
Powered by GitBook
On this page
  • Exchange Server Initialization
  • Checking Your Progress
  • http://localhost/v2/health
  • http://localhost/v2/constants
  • Moving on up!
  1. On-Premise Operators (Advanced Only)
  2. On-Premise Exchange Setup

Server Setup

This is the main part of On-Premise exchange setup process, where we setup the exchange and get it ready for launch

PreviousInstallationNextWeb Setup

Last updated 5 months ago

Before you start with the exchange setup, make sure you have registered on and have created an exchange project. If you don't have access to the Dash, please and the HollaEx team will get in touch.

In addition, the HollaEx Kit folder and CLI must be installed on your machine. Please check the section if you haven't already done so.

Exchange Server Initialization

If you are looking for a way to deploy HollaEx on Kubernetes, Please check out the Kubernetes docs available .

Initialize the exchange setup by running the command below:

hollaex server --setup

The CLI will print some information and then ask for the HollaEx Network selection.

  • The Testnet HollaEx Network allows, unsurprisingly, a testing environment, ideal for developers who are developing plugins.

  • Lastly, if you have a private HollaEx Network, you need to select the Custom HollaEx Network option.

Select the choice relevant to you, and press the enter key to continue.

Once the network is selected, in the case you are connecting to the Mainnet HollaEx Network, the next step is to link your Dashboard account.

Input Y and enter the email and password used in your setup, as well as the OTP code if you have set this up already.

On successful login, a verification code will be sent to the email, copy and paste this over and hit enter.

The HollaEx CLI will then begin to finalize the exchange initialization if all the values are valid.

The CLI then immediately proceeds to build a custom Docker image based on your HollaEx Kit configuration and code. A few questions will be asked during setup so keep an eye on the setup to answer these:

  1. First, if you want to change the image name. Type in the new name or just hit enter to continue.

  2. Confirmation on the name, again hit enter if you are happy.

  3. Finally, if you want to push an image to the Docker Registry. This is optional.

Let it run from this point, and once this initial setup is complete, you will be greeted with a large power symbol, and you can continue.

Now manually start the server. Run the command below to start the exchange - this will be far quicker than the previous step.

hollaex server --start

Checking Your Progress

At this point, it may give some peace of mind to check the progress of the setup, the steps below are not required to finish setup but are a good way to check how the process has gone.

Wait a minute or two after the previous command completes, and then run the command:

hollaex status

Which should return the green text as in the image below. If it doesn't wait a few minutes, try again, as occasionally the setup takes a little time to finalize.

At this point, you should also be able to reach the exchange through your web browser via the endpoints /v2/health and /v2/constant:

This API displays your exchange's name, HollaEx version number, host URL, and base URL.

Moving on up!

The Mainnet HollaEx Network is very likely the choice you will want to make for an operating exchange and to benefit from the .

If you don't have an account, input N, and the Dashboard should open up for you, follow the instructions , come back to the terminal once complete, and then enter your details.

If you get an 'Error: Exchange owner is not verified yet! 'at this step, head back to the dashboard and be sure to complete the to continue

This API shows the list of currencies and trading pairs that you have on your exchange. You will be able to see all currencies and trading pairs you selected. If you don't see a list of your currencies or trading pairs, restart the exchange by running the command hollaex server --restart. If that doesn't solve the issue, you can always bring it up to the .

You can view the API documentation for HollaEx and fork the and make your own.

With everything in order let's move on to the !

🧰
shared liquidity of the HollaEx Network
here
http://localhost/v2/health
http://localhost/v2/constants
forum
here
API Docs
web setup
HollaEx Dashboard
submit this form
Installation
here
If you are unsure which one to choose, it's very likely you want the Mainnet
Time to bring out that Dashboard deets
At this point the CLI will issue an API and secret for your exchange. and begin setup
The three questions during setup
Another step completed!
Starting the command...
...and it finishing about a minute later!
Green = Good
Chrome will look a little differnt to Firefox, but it's the same data
This page will have a lot more info than the previous. about the assets and pairs
verification steps