Get a Backup and Restore

Backing up your exchange periodically is extremely important. In this section, we explain how you can get a backup of your exchange and then restore it.
Backup
There are 3 things you should always periodically backup and store safely.
HollaEx Kit folder
Exchange Database
psql & pg_dump installed on the machine
HollaEx Kit folder
The HollaEx Kit folder got every necessary configuration for your exchange, certain credentials, and secrets used. It includes your exchange name, logo, currencies, trading pairs, and even your secrets such as database passwords. So please make sure to always keep it safe. It also means that by keeping the HollaEx Kit safe, It is very easy to recreate the entire exchange infrastructure.
Exchange Database
The HollaEx Kit exchange stores all exchange-related activities at the database. It uses PostgreSQL, so you can use any PostgreSQL-compatible dump tool to backup data. If you are using an external PostgreSQL database with HollaEx, we recommend you keep an eye on your database provider's backup feature. HollaEx CLI also provides a one-line command to easily dump the entire database.
hollaex toolbox --backup
Life hack tip: hollaex toolbox --backup --skip will make the backup command not show any interactive screen. This would be useful for building an automated backup Cronjob.
After a successful CLI dump of the database, the dump file will be stored in the/backups folder in your HollaEx Kit. The /backups folder is created automatically through the CLI if it doesn't exist.
Restore
You can easily recover the entire exchange assuming you already followed the backup process. 
Simply copy the backup of your HollaEx Kit folder to the desired machine, and reinstall HollaEx CLI by using the install.sh installer at the Kit folder.
Now, run hollaex server --setup command, just like you did initially. This will setup your exchange based on the configuration you have already set. 
Please proceed until the exchange gets set up and running. You can refer to the Setup section of the docs.
Once the exchange is set and running, run the command below.
hollaex toolbox --restore <YOUR_DATABASE_DUMP_FILE_PATH>
 This command will take care of all of the data restore procedures. 
After that, simply restart the server with hollaex server --restart when the procedures are done.
Troubleshooting at the restore
pg_restore: error: input file appears to be a text format dump. Please use psql.
This error could happen when the dump file is generated in a text format. The older version of HollaEx CLI had a text-formatted dump file generation. This is no longer being used, but if you have a dump generated a while ago, you could face this problem. 
If you are facing this problem, you could fix it by going through the restore procedure manually.
The commands below would drop your current hollaex database and create a new empty one for the restoration. 
psql -h localhost -p 5432 -U hollaex -d postgres
DROP DATABASE hollaex;
CREATE DATABASE hollaex;
Run the command below afterwards to finish the restoration.
psql -h localhost -p 5432 -d postgres -U hollaex -W -f <DUMP_FILE_PATH>
If it asks for the DB password during the restore, you could check it at your HollaEx Kit's settings/secret file. The HOLLAEX_SECRET_DB_PASSWORD key is the one for the password.

How-tos - Previous

Get Exchange Logs

Next - How-tos

Use Custom Domain

Last modified 4d ago

Copy link

Outline

Troubleshooting at the restore