Run Dev Mode
Last updated
Last updated
Clone the HollaEx Kit Github repo:
In order to start the server in dev mode you need to run the following:
Before you proceed, please set up a new exchange on the HollaEx Dashboard. Please visit for the mainnet connection or for the testnet connection.
You need to get 2 things here.
Exchange Keys (API Key and API Secret)
Mainnet -
Testnet -
Activation Code
Mainnet -
Testnet -
Please save them somewhere safe. You'll need those very soon.
Enter the HollaEx Kit folder with cd hollaex-kit/
cd server/
make a new env file mv tools/hollaex-kit.env.local.example tools/hollaex-kit.env.local
Open the new tools/hollaex-kit.env.local
file with a text editor/ IDE.
Fill up API_KEY
, API_SECRET
, and ACTIVATION_CODE
values you got from the HollaEx Dashboard.
API_KEY
and API_SECRET
are for the exchange keys.
ACTIVATION_CODE
is for the activation code.
Run docker-compose up
to start the server.
Once docker is all set, open a new terminal window, and check the status of the containers with docker ps
. There should be 4 containers for nginx
redis
postgresql
and the kit server
Go inside the Docker container, by running docker exec -it server_hollaex-kit-server_1 /bin/bash
Once you are successfully inside the docker container you should run the following commands:
Run database migrations: sequelize db:migrate
Run database seed: sequelize db:seed:all
Run database triggers: node tools/dbs/runTriggers.js
Run activation to activate the exchange: node tools/dbs/setActivationCode.js
On the terminal that you ran docker-compose up
, press ctrl + c to stop the process, then run docker-compose up
again to apply the new settings.
One thing we can do to see dev mode in action is run the pre-existing 'hello-exchange' plugin. This will have been downloaded as part of the cloning process above and can be found at:
hollaex-kit/plugins/src/plugins/hello-exchange
Whilst docker-compose up
is running in one terminal, in another terminal, enter the hollaex-kit_server docker container with:
docker exec -it server_hollaex-kit-server_1 /bin/bash
(just as in step 7 above).
Once in the container run:
node plugins/dev.js --plugin=hello-exchange
Give it a little time (until 'info: HELLO-EXCHANGE PLUGIN initializing...' is printed) and from your browser access:
You should see the output in the image below.
Now let's edit the hello-exchange plugin, access the following file (I will be in my IDE):
hollaex-kit/plugins/src/plugins/hello-exchange/server/script.js
Edit the returned JSON object highlighted in the image above. Here the message has been altered from retrieving values from the config file, and elsewhere, to the string "Something new!"
Now go back to the terminal where we built the plugin (where the node command was run) and stop the process, and rerun it (node plugins/dev.js --plugin=hello-exchange).
Refresh the localhost browser page, and we will see that a new message is now displayed.
From this very quick example, you can see the benefit of dev mode, rather than needing to completely rebuild the codebase, we have been able to quickly make a change, rebuild it in seconds and see that change reflected.
Once you have completed all the above, and either come out of dev mode or rebooted your machine, fortunately, to get back into dev mode the only command required to run is docker-compose up
in the /server directory. Easy peasy.
/web
folder in HollaEx Kit is a ReactJS project that contains all the front-end code.
To run it locally in development mode, you need to run: npm start
which installs all the dependencies and starts the browser on http://localhost:3000
.
Changes are applied and updated live on the site.
You can change this value in /web/src/config/index.js
Change DEVELOPMENT_ENDPOINT
to your custom HollaEx Kit server API.
By default, it connects to the default HollaEx Kit which is HollaEx Sandbox