# Web Setup

## About the Web Client server

HollaEx Kit provides a web client-server as an open-source project for a[ HollaEx Kit exchange](https://github.com/bitholla/hollaex-kit). 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](broken://pages/-MPcEy_MNSo5jb9HEOVa) 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!

<figure><img src="/files/h1yUuoJm9K7yc7x9V7dM" alt=""><figcaption><p>Give this process about 10-15 minutes, put your feet up and have a break, you've earned it</p></figcaption></figure>

{% hint style="info" %}
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.&#x20;
{% endhint %}

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.

<figure><img src="/files/IinGOjuXnhzkF0MyFSDx" alt=""><figcaption><p>Only a few more minutes now!</p></figcaption></figure>

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

```
hollaex web --start
```

This should be really quick to complete.

<figure><img src="/files/o3n0cZiWXvsFuAsx4ZDX" alt=""><figcaption><p>This check is differnent from the last images check, promise</p></figcaption></figure>

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.

<figure><img src="/files/XP7QjJvPBlcUCQkpiIGD" alt=""><figcaption><p>Woop Woop</p></figcaption></figure>

{% hint style="warning" %}
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](/get-started/on-premise-exchange-setup/use-custom-domain.md).
{% endhint %}

## 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>.&#x20;

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.

<figure><img src="/files/dAnVOfIC2sJ97pQMW8NZ" alt=""><figcaption><p>Choose the email and password, and then login with the credentials</p></figcaption></figure>

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

<figure><img src="/files/PhXkeJVc7SKZo49uwBxh" alt=""><figcaption><p>Run through these last 5 steps and you will have an exchange!</p></figcaption></figure>

{% hint style="info" %}
Similar to the Dashboard, all these settings can be changed after this setup, so don't stress too much at this point
{% endhint %}

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](/how-tos/set-up-the-smtp-email.md), so feel free to hit skip. Of course, if you are ready and know your settings feel free to set this up right away.&#x20;

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.&#x20;

<figure><img src="/files/i4BFue7mjRN9QpXebLop" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/YzXkU3KN4B9NCcNnDxbA" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="/files/0iVMcV1pOPZLUkhtXubj" alt=""><figcaption><p>The fruits of your labour!</p></figcaption></figure>

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**](https://www.youtube.com/@HollaEx)**:** 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](https://twitter.com/HollaEx) and [Discord](https://discord.gg/RkRHU8RbyM).
4. [HollaEx Forum](https://forum.hollaex.com): 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](/get-started/on-premise-exchange-setup/use-custom-domain.md) to learn how to get your exchange live onto your own domain, and open to the world wide web!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hollaex.com/get-started/on-premise-exchange-setup/web-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.