Web Setup

So close to the end now! By the end of this page we will be able to get away from the terminal, and see some more interesting pages in the browser

About the Web Client server

HollaEx Kit provides a web client-server as an open-source project for a HollaEx Kit exchange. It's included in the /web directory of your HollaEx Kit. The default client contains everything needed for your exchange but feels free to customize it based on your needs. Check here to see more about web customization.

To begin with, from the terminal (after completing hollaex server --start from the previous page) run the following:

hollaex web --setup

This command will build the web client Docker image and carry out the initialization jobs. This build process will likely be the longest wait so far, so just hang tight, this is the last long wait you will have to endure!

During the build, there may be errors printed by the npm package manager. Most of them will not affect the build process itself. You can ignore them unless the build procedure gets killed.

Just as when we did the server setup, the CLI will ask us for the image name, and if we want to backup to the Docker registry. Feel free to choose the same choices you did in the server setup.

Once this is complete you will see a nice, big check as in the image below.

Once this process is complete, the next command to start everything up is:

hollaex web --start

This should be really quick to complete.

This will open your browser automatically but if not, head over to your browser and enter the URL localhost:8080 into the address bar, or click: http://localhost:8080. You will be greeted with the page below.

If you are running the Kit on a remote server, accessing the web will not be available at this stage. You will face errors (or a blank page) if you go to the web with a plain IP address. To make it work, you must bind domains both for the web and the API server to make it accessible externally. Please follow the hollaex prod command instructions.

The Final Steps

At this point, you can move fully over to the browser, and leave the terminal behind for a little while.

The final few steps are all through the page on http://localhost:8080.

The first step is to create the operator admin account. This is vital as these are the credentials that in the future will be used for on-exchange operations. This could be the same as what was used for the dashboard, or a different account, but remember that these credentials will be essential to access the exchange in the future.

Once the credentials have been chosen, and you log in there will be 5 (optional) steps, to finish up the setup:

Similar to the Dashboard, all these settings can be changed after this setup, so don't stress too much at this point

  1. Time zone & language: Choose the time zone you are in, and what language should be chosen as the default

  2. Admin account security: This step is necessary and the only one that can't be skipped. Simply scan the code with an authentication app on your phone and follow the instructions given. If you have never seen an Authenticator app before hit the link under the QR code for some full instructions on what to do.

  3. Assets & Trading: Here you will have a chance to review what assets and pairs you choose on the Dashboard setup, and also choose the 'Native Currency' which will be used as the base currency unit on your exchange.

  4. Features: Here the choice of what features are enabled can be chosen. For DIY Basic users the only options will be enabling the Pro and Quick Trade. Other features are enabled on Cloud Packages and the On-Premise Boost Plan.

  5. Email: The final step is to set up your email service, if you don't have this ready to go don't worry, this can be sorted once we are in the exchange, so feel free to hit skip. Of course, if you are ready and know your settings feel free to set this up right away.

Once these above steps are sorted, congratulations! There have been a few steps to get here, but you have made it, you are two clicks away from your own exchange! We will have one final review page, as in the image below.

Hit confirm and wait until you see this screen as in the below image. Hit that final button...

And Voila! Say hello to your new exchange! It's great you have stuck with us through this process and now you can play around with the exchange; check out the trading graphs, customize the themes and other settings, and a whole host of other bits and pieces to enjoy.

At this point, all the settings are open to you, and to learn more there are a vast array of resources to help you out:

  1. The Docs: Luckily you are already here, the docs contain the entirety of information on what can be done, and how to do it on your exchange.

  2. Youtube: The HollaEx Youtube channel is regularly updated with videos showing off features and live walkthroughs on how to use them.

  3. Social Media: HollaEx is active on various places, including Twitter and Discord.

  4. HollaEx Forum: The forum is the perfect place to ask questions & get answers. Feel free to join the community!

  5. Help Pages: These pages have been specially made for operators in your position, to help cover any gaps that the above pages might have missed out.

The (Real) Final Step

Whilst you have full access to your exchange and can get it prepared and customized there is one (fairly large) issue left to resolve. That is that you are the only person who can actually use your brand-new exchange!

Read onto the next page to learn how to get your exchange live onto your own domain, and open to the world wide web!

Last updated