2.1 Creating a TestRail backup

We recommend creating backups of your TestRail installation regularly and especially when upgrading to a new TestRail version. There are three parts that need to be considered when backing up TestRail: the database, the installation files and the attachments. See below for how to backup these application parts.

1. Database Backup

As most TestRail data is stored in its database, backing up the TestRail database is critical. Please create backups of the database by using the tools of the specific database you are using (i.e. SQL Server or MySQL).

2. Installation files

You should also backup all the TestRail installation files, i.e. the files that are stored in your web server's root directory. The installation files also contain the TestRail configuration (config.php) with information on how to connect to the database.

3. Attachment files

Last but not least you should also backup the attachment files that are stored in the attachment directory you configured. You can look up the configured attachment directory in TestRail's Administration area under Site Settings.

Restoring a backup

In case you need to restore a TestRail installation, just restore the database backup and copy the backuped installation and attachment files to their previous locations. If your server configuration changed between creating and restoring the backup, you might need to manually edit the config.php file to configure the new database connection settings. Likewise, if the location of the attachments directory changed, configure the new directory in TestRail's Administration area under Site Settings after the application has been restored.

Back to TestRail Administration Guide