Restoring Procedures

A restoring procedure refers to recovering data or restoring the functionality of a device, software, or system. The procedure may involve using backup files to restore lost or damaged data, re-installing software applications, and repairing or replacing hardware components.
This page explains how to restore the database in PlexTrac.
This should only be used when necessary due to the risk of data loss.


  • Access to command-line where PlexTrac is hosted
  • Recent backup performed using the PlexTrac Utility
  • Possession of Couchbase, Postgres and uploads in tar.gz format (See instructions here on how to perform a backup and prepare it to be moved to a new host)

Restoring Process

Step 1: For the most consistent results, create a new directory in /opt/plextrac and move any content from /opt/plextrac/backups/couchbase/, /opt/plextrac/backups/postgres/, and /opt/plextrac/backups/uploads/ to this new directory.
If you do not see the directories listed above, the plextrac backup command has likely not been run yet. Once this command is executed, the directories will be created.
Step 2: Place only the desired {{uploads}}.tar.gz to restore into the following directory: /opt/plextrac/backups/uploads.
Step 3: Place only the desired {{couchbase}}.tar.gz in the /opt/plextrac/backups/couchbase.
Step 4: Place only the desired {{postgres}}.tar.gz in the /opt/plextrac/backups/postgres.
During Steps 2-4, verify when placing the files in the given directories that only these files exist. The existence of other files or directories may lead to errors during the restore process.
Step 5: Run plextrac restore. Depending on the database size and upload directories, it might take several minutes to complete.
plextrac restore -v
Step 6: Enter yes or no to proceed with the restore of Postgres, then enter yes or no to restore Couchbase, and finally enter yes or no to restore the uploads.
Step 7: Once both sections have been completed, navigate to the platform and check that the data has been restored.
© 2023 PlexTrac, Inc. All rights reserved.