Manual Backup and Restore

TeamCity Data Directory stores:

• server settings, projects and build configurations with their settings (that is, all that is configured via the UI);

• build artifacts by default, unless a different location is configured. Build logs are also stored as a part of the build artifacts;

• current operation files, internal data structure, and so on.

For more details on the directory structure and data, refer to the TeamCity Data Directory section.

If necessary, you can exclude parts of the directory from the backup to save space: you will only lose the excluded data. You may safely exclude the system/caches directory from the backup — the necessary data will be rebuilt from scratch on TeamCity startup.

If you decide to skip backing up data under <TeamCity Data Directory>/system directory, make sure you note the most recent files in each of the artifacts, messages, and changes subdirectories and save this information. It will be needed if you decide to restore the database backup with the TeamCity Data Directory corresponding to a newer state than that of the database.

The <TeamCity Data Directory>/system/buildserver.* files store the internal database (HSQLDB) data. You need to back them up if you use HSQLDB (the default setting not suitable for production use).

The database stores all information on the build results (build history and all the build-associated data except for artifacts and build logs), VCS changes, agents, build queue, user accounts and user permissions, and so on.

• If you use the HSQLDB, the internal database (default setting, not recommended for production), the database is stored in the files residing directly in the <TeamCity Data Directory>/system directory. All files from the directory can be backed up. You may also refer to the HSQLDB backup notes.

• If you use an external database, back up your database schema used by TeamCity with database-specific tools. For the external database connection settings used by TeamCity, refer to the <TeamCity Data Directory>/config/database.properties file. You can also see the corresponding installation section.

You do not need to back up TeamCity application directory (web server alone with the web application), provided you still have the original distribution package and you did not:

• place any custom libraries for TeamCity to use

• install any non-default TeamCity plugins directly into web application files

• make any startup script/configuration changes.

If you feel you need to back up the application files:

• If you use a non-war distribution: back up everything under <TeamCity Data Directory> except for the temp and work directories.

• If you use the war distribution, follow the backup procedure of the servlet container used.

If you need TeamCity server log files (which are mainly used for problem-solving or debug purposes), back up the <TeamCity Data Directory>/logs directory.

note

You may also want to back up TeamCity Windows Service settings, if they were modified.

You can simply put the previously backed up files back to their original places. However, it is important that no extra files are present when restoring the backup. The simplest way to achieve this is to restore the backup into a clean Data Directory. If this is not possible, make sure the files created after the backup was done are cleared. Especially the newly created files under the artifacts, messages, changes directories under <TeamCity Data Directory>/system.

The database must be restored using the database-specific tools and methods. You might also want to use database-specific methods to make the restore faster (like setting SQL Server "Recovery Model" to "Simple").

Prior to restoring, make sure there are no extra tables in the schema used by TeamCity.

If you want to run a copy of the server, make sure the servers use distinct data directories and databases. For an external database, make sure you modify settings in the <TeamCity Data Directory>/config/database.properties file to point to a different database.

Build logs located in the /logs subdirectory of /artifacts from multiple artifact directories are backed up and restored into the single directory system/<project ID>/<build configuration name>/<internal_build_id>/.teamcity/logs.