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

  • A 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 that only these exist when placing the files in the given directories. The existence of other files or directories may lead to errors during the restore process.

Step 5: Run plextrac restore. It might take several minutes to complete, depending on the database size and upload directories.

plextrac restore -v

Step 6: Enter yes or no to proceed with restoring 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.

Last updated

© 2024 PlexTrac, Inc. All rights reserved.