YouTrack Standalone 2018.1 Help

Upgrade with Docker Container

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

Upgrade a Docker Image

  1. Create a backup of the YouTrack database while your existing YouTrack installation is running.
  2. Stop the running YouTrack docker container.
  3. If you use the --name parameter with the docker run command, remove the container with the previous version. Otherwise, when you run the new version of the container, the command will fail because of the container names conflicts.
  4. Pull an image of the latest YouTrack version from the Docker YouTrack Repository:
    docker pull jetbrains/youtrack:<version>

    Where <version> is a full version number of an YouTrack build.

  5. 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.
  6. In a browser, open the web-based Configuration Wizard by the URL.
  7. Review the upgrade settings.
  8. 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.

  9. 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 a ZIP or MSI Installation with Docker Image

  1. Create a backup of the YouTrack database while your existing YouTrack installation is running.
  2. Stop the existing YouTrack service.
  3. Pull an image of the latest YouTrack version from the Docker YouTrack Repository:
    docker pull jetbrains/youtrack:<version>

    Where <version> is a full version number of an YouTrack build.

  4. Create and configure YouTrack-specific directories on the host machine.
  5. Copy the backup file of the YouTrack database into the backups directory, that you created in the previous step.
  6. 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.
  7. In a browser, open the URL to access the wizard.
  8. In the Configuration Wizard, click Upgrade.
    yt upgrade config wizard start
  9. On the Select Upgrade Source page, click the Select button and select the backup file as an upgrade source.
    docker upgrade select source
    Click Next.
  10. On the Confirm Settings page, confirm your system settings and the location of system directories.
    docker upgrade confirm settings
  11. 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.

  12. 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: 31 May 2018