:navigation-title: Maintenance

..  include:: /Includes.rst.txt
..  _admin-tools-maintenance:
..  _system-maintenance:

====================
Maintenance (System)
====================

..  versionchanged:: 14.0
    This module has been moved from :guilabel:`Admin tools` to :guilabel:`System`
	see `Feature: #107628 - Improved backend module naming and structure <https://docs.typo3.org/permalink/changelog:feature-107628-1729026000>`_.

Only available if :composer:`typo3/cms-install` is installed.

The backend module :guilabel:`System > Maintenance` offers tools
to system maintainers that are necessary during development or updates.

Some of the tools available here include:

..  todo: describe the other tools

..  contents::

..  _admin-tools-maintenance-flush-cache:

Flush TYPO3 and PHP Cache
=========================

By clicking the button :guilabel:`Flush cache` you can flush all caches. This is
necessary during development if you changed files like
:ref:`Fluid templates <fluid-templates>`, :ref:`TypoScript files <typoscript>`,
or PHP files.

It is also necessary to flush caches after installing or updating extensions.

You can achieve the same effect by calling

..  code-block:: bash

    ddev typo3 cache: flush

..  note::
    Flushing the cache via the "Clear cache" buttons in the
    :ref:`Top Bar <top-bar>` does not have the same effect. It does not flush
    PHP related caches.

..  _admin-tools-maintenance-database-analyzer:

Analyze Database Structure
==========================

Aside its name this tool does not only analyze the database structure but also
offers to fix it for you.

Database changes can be necessary when :ref:`TCA files <tca>` where changed or
extensions installed / updated.

..  _admin-tools-maintenance-create-admin:

Create Administrative User
==========================

This tool can be used to create a new administrative backend user with or
without maintainer privileges.

You can also create a new backend user from the console:

..  code-block:: bash

    ddev typo3 backend:user:create

and from the module :guilabel:`Administration > Users`. The latter cannot
grant system maintainer rights but is available to all admins.

..  _admin-tools-maintenance-reference-index:

Check and Update Reference Index
================================

..  versionchanged:: 14.0
    This tool has been moved here from module :guilabel:`System > DB Check`.

TYPO3 keeps a record of relations between all records.
This may get out of sync when certain operations are performed
without the strict context of the backend. It is therefore
useful to update this index regularly.

You can also use the following console command:

..  code-block:: bash

    ddev typo3 referenceindex:update

The console command has the advantage that it does not cause time outs on large
pages.