Upsource 2017.1 Help

Upgrade from Docker to Docker

Follow this instruction to patch-upgrade your existing Docker installation to a newer minor version (i.e. 2017.1.0 to 2017.1.5) with a Docker distribution.

  1. Stop the running container with your existing Upsource version:

    docker exec <containerId> stop
  2. Pull an image of the latest Upsource version from the Docker Hub Repository:

    docker pull jetbrains/upsource:<version> Where <version> is a full version number of an Upsource build.
  3. Run the new docker container and map Upsource data volumes and port:

    docker run -it --name <upsource-server-instance> \ -v <path to data directory>:/opt/upsource/data \ -v <path to conf directory>:/opt/upsource/conf \ -v <path to logs directory>:/opt/upsource/logs \ -v <path to backups directory>:/opt/upsource/backups \ -p <port on host>:8080 \ jetbrains/upsource:<version>


    <upsource-server-instance> is a name you give to the container.

    -v <path to data directory>:/opt/upsource/data maps the data directory in the container to the corresponding data directory left on the host machine from the previous installation. The same mapping is set for the other directories: conf, logs, backups.

    -p <port on host>:8080 this port mapping instructs your host machine to listen on <port on host> and propagate all traffic to port 8080 inside the Docker container.

    jetbrains/upsource:<version> points to an image with the new Upsource version.

  4. Follow the wizard.

    After the container of the new version finishes the startup process, the Configuration Wizard is deployed and listens on the main Upsource port at the URL that ends with some non-root context:


    The wizard URL is printed in the console output and is recorded in the logs:

    "JetBrains Upsource Configuration Wizard will be available on [http://<host>:<port>/contextPath] after start"

    Look it up in the console, access the wizard, then follow its steps to finish the upgrade process.

    Meanwhile the Upsource service URL will be showing a page with the "Upgrade in progress" notice to Upsource end users.

  5. You can now remove the old container with the following command:

    docker rm <containerId>

    To see all stopped containers, run:

    docker ps -a
Last modified: 13 July 2017