---
description: >-
  This page describes how to upgrade from an existing dms+ version to a newer
  version.
---

# Upgrades

## Docker

Upgrading to a newer version of the **dms+** application with docker is pretty easy:

All you need to do is to change the release tags of the images for the `app` and the `scanner` containers in the `docker-compose.yml` that you use to start-up the docker containers:

```
...
services:  

  # OCR utility
  scanner:
      image: dl0pes/dmsocr:1.1.2
      container_name: scanner
      ...

  # webapp
  app:
      image: dl0pes/dmsweb:1.1.2
      container_name: app
      ...
```

Afterwards you simply need to restart the docker containers with the following script that automatically handles all necessary docker commands for you:

`sh ./dms-restart.sh`

> **CAUTION:** since the docker containers for the `app` and the `webserver` share one and the same docker volume in order to access the PHP files and static resources, these files would normally NOT be updated during startup of these docker containers. Therefore, it is currently necessary to delete the docker volume in between the shutdown and startup of the `app` and `webserver` docker containers. The `dms-restart.sh` script takes care of this. So, if you run the docker-compose commands manually (for whatever reason), please keep in mind to also run `docker volume rm {DOCKER_VOLUME_NAME}` in between the shutdown and startup

## other

> **HINT:** A reliable description for upgrading to a newer version of **dms+** without docker cannot be provided yet - mostly because this has not been thoroughly tested. Brave enough users can try out the given explanation in this section. Feedback is welcome :)

Basically you should be able to just download your desired release from the [release overview](https://github.com/d-lopes/dmsplus/releases) and overwrite your existing `LARAVEL_HOME` and `SCANNER_HOME` directories (assuming you haven't renamed those directories they should be named `laravel` and `scanner` in the directory you have placed the application).

> **CAUTION:** remember to re-apply any additional changes that you have made to the upgraded files.
