Upgrading Traq

This guide explains how to safely update your self-hosted Traq instance to the latest version.

Always Back Up First!

Before performing any upgrade, you must create a backup of both your database and any configuration files, plugins and themes. This ensures you can restore your instance if anything goes wrong.

Make sure to backup:

  • Config files in vendor/traq/config
  • Any plugins you installed into vendor/traq/plugins
  • Themes you installed into vendor/traq/views

Directory Changes in v3.9

These directories (vendor/traq/config, vendor/traq/plugins, and vendor/traq/views) will be moved in v3.9. Make sure to check the upgrade notes for v3.9 when upgrading to that version or later.

Upgrade Steps

  1. Back Up Your Database & Configuration

    • Database: Use a tool like mysqldump to create a complete backup of your Traq database. 

      mysqldump -u YOUR_DB_USER -p YOUR_DB_NAME > traq_backup.sql

    • Configuration, Plugins & Themes: Create a backup of your configuration directory, plugins, and themes. 

      # Run this from your Traq project root
zip -r traq_backup.zip vendor/traq/config/ vendor/traq/plugins/ vendor/traq/views/

  2. Download the Latest Version Get the latest stable .zip or .tar.gz release from the official website.

  3. Extract and Upload Files Extract the new version on your local machine. Using an FTP/SFTP client, upload the new files to your server, overwriting the existing application files.

    Restoring Configuration, Plugins & Themes

    After uploading, check your vendor/traq/config/, vendor/traq/plugins/, and vendor/traq/views/ directories. If your custom settings, plugins, or themes were overwritten, restore them from the traq_backup.zip file you created in Step 1.

  4. Run Database Migration After-replacing the files, visit your Traq instance in your web browser. Traq should automatically detect that an upgrade is needed and present an on-screen prompt to run any necessary database migrations.

    Already up to date

    If you are not automatically redirected, you may already be up to date with any database changes. If you would like to double check, you can navigate to /install/upgrade.php, if it reports "Already up to date" then there is nothing you need to do.

  5. Clear Caches Clear your browser cache to ensure you are loading the new version's JavaScript and CSS files.