Installation and Upgrade Guide

Version:9.5 Language:en Author:TYPO3 contributors License:This document is published under the Open Publication License. Rendered:2022-03-26 11:28

---

This document explains how to install and upgrade TYPO3 and migrate from Legacy to Composer mode.

---

• Introduction
  • About this Document
  • What’s New
  • Credits
  • Contribution
  • Contact the Documentation Team
• Installing TYPO3
• Installation explained
  • System Requirements
    • Database Environment
      • Required Database Privileges
    • Web Server Environment
      • Apache
      • Microsoft Internet Information Services (IIS)
      • NGINX
      • PHP Environment
        • PHP Required Extensions
  • Which Package and Which Format?
    • Which File Format to Use
  • The Package in Detail
    • TYPO3 Folders and Files on Root Level
      • The ‘public’ Folder
      • The var Folder
    • Custom Folders?
  • TYPO3 System Management
    • Maintenance
    • Settings
    • Upgrade
    • Environment
  • The Distributions
    • Introduction Package
  • Translating the Backend
    • Download Translations for the Backend
    • Change the Language for a Backend User
• Working With Composer
  • Run Composer Locally
  • Update Packages
    • Update all Packages
    • Update Single Packages
      • Update TYPO3 Core
      • Update Extensions Like “news”
  • Use Dev Requirements
  • Remove Extensions
  • Check for Available Updates
  • Useful Packages and Bundles
    • Simplify “Subtree Split” Installations
    • TYPO3 CMS Base Distribution
    • Secure Web
• Extension Installation
  • Install an Extension Without Composer
  • Install an Extension With Composer
    • Find out Composer Package Name for an Extension
  • Extension Dependencies
  • Additional Information
    • Find out the Extension Key for an Extension
• Upgrade
  • Preparation
    • Before You Start
    • Handling Deprecations
    • Upgrade Hints for version 9
      • Database Collation and Charset
  • Backup
  • Reference Index
    • With Command Line (Recommended)
    • Without Command Line
  • Install the New Source
    • Upgrading a Composer Based System
    • Using the Core Updater
    • Installing the Source Manually
    • What’s the Next Step?
  • Convert Global Extensions
  • Use the Upgrade Wizard
  • Run the Database Analyzer
  • Clear User Settings
  • Clear Caches
  • Check the ChangeLog
  • Update Extensions (non-Composer Installations)
  • Update Translations
  • Upgrade to v9.5
    • Before Upgrade
    • During Upgrade
      • Upgrade Wizards
        • “Introduce URL parts (“slugs”) to all existing pages”
      • Additional Steps
    • More Information on New Features
• Migrate TYPO3 Project to Composer
  • Requirements
    • TYPO3 version
    • Composer
    • Folder structure
    • Code Integrity
  • Migration Steps
    • Delete Files
    • Configure Composer
    • Add All Required Packages to Your Project
      • Install the Core
      • Install Extensions from Packagist
        • Notice on Extension’s TER Page
        • Check in TER Satis
        • See Warning During composer require Command
        • Check Manually
      • Install Extension from TER
      • Install Extension from Version Control System (e.g. GitHub, Gitlab, …)
    • Include Individual Extensions like Site Packages
    • New file locations
  • Co-working
    • Add to version control system
    • Checkout from version control system
  • Best Practices
    • Completely Clear typo3conf/ext Folder
      • Define a Local Path Repository
      • Include Your Individual Extensions From packages Folder
      • Exclude typo3conf/ext from Version Control System
• Migrate content
  • Prerequisites
  • Export your data
  • Import your data
  • Importing data from old TYPO3 versions
• TYPO3 Release Integrity
  • Release package contents
  • Checking file hashes
  • Checking file signatures
  • Checking tag signature
  • Public Keys
• Troubleshooting
  • Apache
    • Enable mod_rewrite
    • Adjust ThreadStackSize on Windows
  • PHP
    • Install Tool
    • PHP Caches, Extension Classes etc.
    • Opcode cache messages
      • No PHP opcode cache loaded
      • This opcode cache is marked as malfunctioning by the TYPO3 CMS Team.
      • This opcode cache may work correctly but has medium performance.
      • This opcode cache should work correctly and has good performance.
  • MySQL
    • Character Set
  • TYPO3
    • Cached Files in typo3temp/
    • Possible Problems With the Cached Files
      • Changing the absolute path to TYPO3
      • Changing Image Processing Settings
• Historical Information
  • Breaking Changes in Extbase and Fluid in Version 1.1 - 6.2
    • Breaking Changes in Extbase and Fluid
      • Version Matrix
      • From Extbase 6.1 to Extbase 6.2
        • Extbase
        • Fluid
      • From Extbase 6.0 to Extbase 6.1
        • Extbase
        • Fluid
      • From Extbase 4.7 to Extbase 6.0
        • Extbase
        • Fluid
      • From Extbase 1.4 to Extbase 4.7
        • Extbase
      • From Extbase 1.3.x to Extbase 1.4.0
        • Extbase
        • Fluid
      • From Extbase 1.2.x to Extbase 1.3.0
      • From Extbase 1.0.2 to Extbase 1.2.0