> For the complete documentation index, see [llms.txt](https://d-lopes.gitbook.io/dmsplus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://d-lopes.gitbook.io/dmsplus/upgrade-to-new-version.md).

# 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://d-lopes.gitbook.io/dmsplus/upgrade-to-new-version.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.