Alteryx Promote

Definitive answers from Promote experts.
Register for the upcoming Live Community Q&A Session - and don't forget to submit your questions for @DeanS regarding the future role of analytics here.

How To: Backup your Promote PostgreSQL Database

Alteryx Alumni (Retired)

How To: Backup the Promote PostgreSQL database


Promote uses a PostgreSQL database. This article explains how to create a backup of a Promote instance's database. Backing up your Promote database can save you time and headaches in the event of a system failure.




  • Alteryx Promote ≥ 2018.1




  1. The PostgreSQL database must be backed up from the Master node, and not just the Leader node (note: these can be the same node). To return a list of node IDs, run the following command:

    docker node ls --format='{{.ID}}'
  2. To check if a node is the Master node, run the following command on each node ID from the list returned by the above command, replacing {node_id} with the node ID.

    docker node inspect {node_id} --format='{{.Spec.Labels.master}}' 
  3. Once you have determined the Master node (where "yes" is the returned response value from the above command), run the following commands from that node to start the PostgreSQL backup process.

      1. On the host machine run the following bash command:

        docker exec -it $(docker ps | grep promote-db | awk '{print$1}') bash
      2. Run the backup script:

        sh /scripts/
      3. Change to the directory of the database backup:

        cd /var/backups/postgres
      4. Copy the backup file to the host machine (the node that is hosting the promote-db docker container) from the database container (promote_app). This command needs to be run outside of the database container, changing /location/path to the database path on the host machine:

        docker cp $(docker ps | grep promote-db | awk '{print$1}'):/var/backups/postgres/{backup db name} /location/path 

    A backup of your database should now be saved in your specified directory. You deserve a coffee!

5 - Atom



Is this based on pure code ?