Upgrade with Docker Container

This page describes various scenarios of upgrading an existing YouTrack service using the YouTrack docker image.

Prerequisites

Before you upgrade, perform the following prerequisite tasks:

Create a backup of your current database. YouTrack Standalone does not provide forward database compatibility. Your database is migrated to the format that is compatible with the latest version during the upgrade procedure. This means that you cannot revert to a previous version and continue to use the database that was processed during the upgrade.
Copy the backup of your current database to a secure location just in case you encounter problems with the upgrade and need to roll back to the previous version.
Verify that your YouTrack license supports the upgrade. To view the license limitations, open the Administration menu and select System Settings > Global Settings, then select the License Details tab. If your free update period has expired, you need to extend your subscription.
Mind the recommended upgrade path. The current version of your installation is shown at the bottom of almost every page in the application (not on agile boards).

Recommended Upgrade Path

Existing version	Upgrade to version
6.5 or earlier	YouTrack 7.0
7.0	2017.1
2017.x	2018.x
2018.x	2019.x
2019.x	2020.x
2020.x	current

Upgrade a Docker Image

Create a backup of the YouTrack database while your existing YouTrack installation is running.
Stop the running YouTrack docker container:
docker exec <CONTAINER_ID> stop
To get the <CONTAINER_ID>, use the command:
docker ps -a
Remove the container with the previous version.
docker rm <CONTAINER_ID>
Otherwise, when you run the new version of the container, the command will fail because of the container names conflicts.
Pull an image of the latest YouTrack version from the Docker YouTrack Repository:
docker pull jetbrains/youtrack:<version>
Replace <version> with the complete version number and build. For a complete list of release versions, check Docker Hub.
Execute the following command to run a container with the new YouTrack version, that you have pulled from the repository. All other attributes of the command (volumes and port mappings) must be the same as you have used to run the previous version of the YouTrack image:
docker run -it --name <arbitrary-youtrack-container-name> \ -v <path to data directory>:/opt/youtrack/data \ -v <path to conf directory>:/opt/youtrack/conf \ -v <path to logs directory>:/opt/youtrack/logs \ -v <path to backups directory>:/opt/youtrack/backups \ -p <port on host>:8080 \ jetbrains/youtrack:<new version>
- In the console output, an URL to the web-based Configuration Wizard is provided.
In a browser, open the web-based Configuration Wizard by the URL.
Review the upgrade settings. Click Next.
Review your license. If required, you can also update your license on this page.
When done, click Upgrade.
- YouTrack Standalone launches its components.
  Do not close the page in the browser until the setup is complete. When the YouTrack Standalone server is ready, you are redirected to the login page.
Enter the credentials for the YouTrack Standalone administrator account and click the Log in button.
- YouTrack opens to the Dashboard page.
Your YouTrack Standalone installation is upgraded and ready to use.

Upgrade an Existing Installation from a Database Backup using a Docker Image

You also have the ability to upgrade any installation type using a docker image by downloading a backup copy of your YouTrack database and using the backup as the upgrade source in the configuration wizard during installation of the latest version.

This procedure can be used to upgrade any installation type (JAR, MSI, or ZIP). It can also be used to migrate an installation from one Docker container to another during the upgrade process.

Create a backup of the YouTrack database while your existing YouTrack installation is running.
Stop the existing YouTrack service.
Pull an image of the latest YouTrack version from the Docker YouTrack Repository:
docker pull jetbrains/youtrack:<version>
Replace <version> with the complete version number and build. For a complete list of release versions, check Docker Hub.
Create and configure YouTrack-specific directories on the host machine.
Copy the backup file of the YouTrack database into the backups directory, that you created in the previous step.
Run the container with YouTrack server and map YouTrack data volumes and port.
- YouTrack service starts with the web-based Configuration Wizard. The URL at which you can access the wizard is displayed in the command output.
In a browser, open the URL to access the wizard.
In the Configuration Wizard, click Upgrade.
On the Select Upgrade Source page, click the Select button and select the backup file as an upgrade source.
Click Next.
On the Confirm Settings page, confirm your system settings and the location of system directories.
Review your license. If required, you can also update your license on this page.
When done, click Upgrade.
- YouTrack Standalone launches its components.
  Do not close the page in the browser until the setup is complete. When the YouTrack Standalone server is ready, you are redirected to the login page.
Enter the credentials for the YouTrack Standalone administrator account and click the Log in button.
- YouTrack opens to the Dashboard page.
Your YouTrack Standalone installation is upgraded and ready to use.

Last modified: 15 April 2021