Attention

TYPO3 v10 has reached end-of-life as of April 30th 2023 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v10 here: TYPO3 ELTS.

Install the New Source

Note

The recommended installation of TYPO3 is based on composer.

Upgrading a Composer Based System

Caution

TYPO3 v10 LTS has no support for the package typo3/cms anymore - instead all TYPO3 system extensions are now single packages. When upgrading, remove the typo3/cms package and require the single packages you need. To make selecting the packages easier, you can use https://get.typo3.org/misc/composer/helper to find the packages you need.

Use composer to update your system via for example:

composer require typo3/cms-backend:^10.4 typo3/cms-core:^10.4 \
   typo3/cms-extbase:^10.4 typo3/cms-extensionmanager:^10.4 \
   typo3/cms-filelist:^10.4 typo3/cms-fluid:^10.4 typo3/cms-frontend:^10.4 \
   typo3/cms-install:^10.4 typo3/cms-recordlist:^10.4 \
   --update-with-dependencies

If you have extensions installed, you will have to find the corresponding newer versions you want to install for your new major version and update them, too.

Example:

composer require typo3/cms-backend:^10.4 typo3/cms-core:^10.4 \
   typo3/cms-extbase:^10.4 typo3/cms-extensionmanager:^10.4 \
   typo3/cms-filelist:^10.4 typo3/cms-fluid:^10.4 typo3/cms-frontend:^10.4 \
   typo3/cms-install:^10.4 typo3/cms-recordlist:^10.4 georgringer/news:^8.0 \
   --update-with-dependencies

To find the matching extension versions you can go to packagist.org, search for your extension and take a look at the requires section.

Tip

The list of system extensions developed directly in the TYPO3 core repository changes from time to time: Some extensions are merged into others, new system extensions are added and others abandoned or released to the public and therefore maintained at a different place. If you want to know details, you can have a look at this list or search in the breaking changes for the extension key (not the package name!).

extension on packagist

The "News" extension on packagist

Using the Core Updater

The Install Tool in the section "Important Actions" provides a function to update the TYPO3 Core.

In the section "Important Actions" scroll down to "Core update" and click the "Check for core updates" button. If the requirements are met, TYPO3 will automatically install the new source code.

Note

For the Core Updater to work, the following setup is required:

  • It only works under Unix and MacOS.

  • typo3_src must be a symlink.

  • This symlink needs to be writable (and deletable) by the web server user.

  • document root needs to be writable.

  • One path above document root (../) needs to be writable (new directories need to be allowed to be created).

  • The tar command must be available for extracting the Source package.

Disabling the Core Updater

The Core Updater functionality can be disabled, in order to avoid users using it, i.e. if you use your own update mechanism.

This feature is already disabled when TYPO3 is installed via composer.

To disable the core updater, you can set this environment variable:

TYPO3_DISABLE_CORE_UPDATER=1

For example in Apache:

SetEnv TYPO3_DISABLE_CORE_UPDATER 1

or for nginx:

server {
  location ~ path/to/it {
    include fastcgi_params;
    fastcgi_param TYPO3_DISABLE_CORE_UPDATER "1";
  }
}

This will disable the button and all related functionality in the Install Tool.

Installing the Source Manually

Go to https://typo3.org/download/ and download the Source package of the new TYPO3 version.

Extract the package on your web server and - in your TYPO3 document root - adjust the typo3_src symlink.

Important

Make sure to upload the whole TYPO3 source directory including the vendor directory, otherwise you will miss important dependency updates.

What's the Next Step?

In case you did a minor update, e.g. from TYPO3 10.4.0 to 10.4.1, database updates are usually not necessary. All you still have to do is to remove the temporary cache files. After that your update is finished.

Note

Make sure to read the release notes even of minor versions carefully. While we take great care to keep the minor updates as easy as possible especially when releasing security updates more steps might be necessary.

In case of a major update, e.g. from TYPO3 9.5 to 10.4, go ahead with the next step!

Also check out the breaking changes listed in changelog for the new version.