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 and 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 once you kept HollaEx Kit safe, It is very easy to recreate the entire exchange infrastructure.

Exchange Database

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 to 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 /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.