---
title: "Upgrading from 2.3 to 2.4"
manual: "Academic Profiles Sync"
version: "main"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-persons-sync:upgrade-from-2-3-to-2-4@main"
source: "Upgrade/From23To24.rst"
rendered: "2026-10-17T08:48:05+00:00"
---

# Upgrading from 2.3 to 2.4 {#upgrade-from-2-3-to-2-4}

Version 2.4 of this extension changes no configuration, no database column and
no API. The upgrade is the package update, made together with the extensions it
depends on. Work through the sections in order. Skip a step that does not apply
to the installation.

## Before you start {#upgrade-from-2-3-to-2-4-before-you-start}

Version 2.4 runs on TYPO3 12.4 from 12.4.22 on and on TYPO3 13.4, with PHP 8.1
or later. That is the same as for 2.3, so the TYPO3 core does not have to
change for this upgrade.

**academic_persons_sync** 2.4 declares no new dependency of its own. It
needs these packages. Upgrade them first or in the same deployment, in this
order, as their own upgrade chapters describe:

-   [`fgtclb/environment-state-manager`](https://packagist.org/packages/fgtclb/environment-state-manager) 1.x, new in 2.4, which
    **academic_base** 2.4 and **academic_persons** 2.4 require.
    Composer installs it on its own. A classic installation installs
    **environment_state_manager** before it activates either of them.
-   [`fgtclb/academic-base`](https://packagist.org/packages/fgtclb/academic-base) 2.4, the same release as this extension.
-   [`fgtclb/academic-persons`](https://packagist.org/packages/fgtclb/academic-persons) 2.4, the same release as this
    extension.
-   [`fgtclb/academic-persons-edit`](https://packagist.org/packages/fgtclb/academic-persons-edit) 2.4, the same release as this
    extension.

## Update the package {#upgrade-from-2-3-to-2-4-package}

```bash
composer require -W \
    'fgtclb/academic-base':'~2.4.0' \
    'fgtclb/academic-persons':'~2.4.0' \
    'fgtclb/academic-persons-edit':'~2.4.0' \
    'fgtclb/academic-persons-sync':'~2.4.0'
```

A project that requires branch `2` as `2.x-dev` keeps an inline alias such
as `2.x-dev as 2.4.x-dev` working, see [Important: The development branch installs as 2.4.x-dev](https://docs.typo3.org/permalink/fgtclb/academic-persons-sync:important-1790796665@main).

On a classic installation, install **environment_state_manager** 1.x
from the TER in **Admin Tools > Extensions** first, then update
**academic_base**, **academic_persons**,
**academic_persons_edit** and **academic_persons_sync** there,
in this order. Run the commands of this page with
`typo3/sysext/core/bin/typo3` instead of `vendor/bin/typo3`.

```bash
vendor/bin/typo3 cache:flush
```

## Check the result {#upgrade-from-2-3-to-2-4-check}

-   Open a frontend user of the type
    **Academic Persons: External User**. The tab with the assigned
    profiles is labelled **Profiles**. Version 2.3 read its label from
    a file that does not exist, so the tab had no label.