# Upgrade guide from Debian 11 to Debian 12

Legacy notice

This page is kept for historical reference only. For EasyDCIM 1.25.0+, the supported operational model is the Docker-based stack managed by easydcim-control, not the older host-based upgrade workflow.

If your system already runs EasyDCIM 1.25.0+ in Docker, use the standard update workflow described in Update Guide.

If your system is still an older host-based deployment, do not treat this page as the primary operational guide for current versions. Instead, move to the Docker-based model by using one of the following migration paths:

# Same server: host-based deployment to Docker

sudo easydcim-control app migrate
sudo easydcim-control agent migrate

Use app migrate for the main EasyDCIM server. A detected local Remote Agent is migrated automatically. Use agent migrate separately for standalone Remote Agent hosts.

# New server: rebuild on a new Docker-based host

  1. create backups on the old server,
  2. reissue the license,
  3. install easydcim-control on the new server,
  4. run:
sudo easydcim-control app install --key 'LICENSE_KEY'
  1. restore the backup on the new stack.

The detailed migration procedure is described in Migration guide from old to new server.

# Historical context

Older EasyDCIM releases were often upgraded by first upgrading the host operating system and then updating the application files directly on the server. That approach applied to the previous host-based deployment model and should be considered legacy-only for current versions.