---
title: "Deploying TYPO3"
manual: "TYPO3 Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3coreapi:deployment@main"
source: "Administration/Deployment/Index.rst"
rendered: "2026-09-19T06:56:03+00:00"
---

# Deploying TYPO3 {#deployment}

This guide explains how to deploy a TYPO3 project to a production environment
securely and efficiently. It covers both **manual** deployment and
**automated** strategies using deployment tools.

TYPO3 can be deployed in various ways. A common and simple approach is to
copy files and the database from a local environment to the live server.

However, for larger or more professional projects,
[automated deployment](https://docs.typo3.org/permalink/t3coreapi:automated-deployment@main)
using tools is highly recommended.

## What is deployment and why do I need it? {#deployment-what-why}

It is recommended to develop TYPO3 projects locally on your computer using Docker,
DDEV, or a local PHP and database installation. At some
point you will want to transfer your work to the server for a first
initial deployment, which can be done manually or semi-manually.

As time goes on, you will fix bugs, prepare updates and develop
new features on your local computer. These changes will then need
to be transferred to the server. This can
be done manually or can be automated.

Deployment can only be avoided if you [Install and use TYPO3 directly on the server](https://docs.typo3.org/permalink/t3coreapi:direct-server-workflow@main),
which comes with a number of [Quick wins & pitfalls](https://docs.typo3.org/permalink/t3coreapi:direct-server-workflow-pro-con@main).

The following sections contain examples of different types of deployment for TYPO3 projects:

**[Initial deployment](https://docs.typo3.org/permalink/t3coreapi:manual-deployment-initial@main)**

Manual deployment of a Composer-based installation. Moving your project to the server.

**[Incremental deployment](https://docs.typo3.org/permalink/t3coreapi:manual-deployment-incremental@main)**

Manual deployment of a Composer-based installation. Ongoing updates to code or configuration.

**[Automated deployment](https://docs.typo3.org/permalink/t3coreapi:automated-deployment@main)**

A description of the "symlink-switching" approach

**[Environments](https://docs.typo3.org/permalink/t3coreapi:multi-stage-environment-workflow@main)**

Deploying TYPO3 projects means careful control of different environments.
This document provides an overview of common environment stages,
deployment flows, and best practices for managing TYPO3 instances across these stages.

-   [Configuring environments](https://docs.typo3.org/permalink/t3coreapi:environment-configuration@main)
-   [Synchronizing database content across environments](https://docs.typo3.org/permalink/t3coreapi:multi-stage-environment-database-management@main)
-   [Synchronizing user-uploaded files across environments](https://docs.typo3.org/permalink/t3coreapi:multi-stage-environment-user-upload-management@main)

**[Tools](https://docs.typo3.org/permalink/t3coreapi:deployment-tools@main)**

The following tools can be used to deploy TYPO3 either manually or in an automated
CI pipeline

-   [Rsync deployment of TYPO3](https://docs.typo3.org/permalink/t3coreapi:deployment-rsync@main)
-   [Deployer for TYPO3 Deployment](https://docs.typo3.org/permalink/t3coreapi:deployment-deployer@main)
-   [Deploying TYPO3 Using Git and Composer](https://docs.typo3.org/permalink/t3coreapi:deployment-git-composer@main)

**[CI/CD: Automatic deployment of TYPO3 Projects](https://docs.typo3.org/permalink/t3coreapi:ci-cd-for-typo3-projects@main)**

**Continuous Integration (CI)** and **Continuous Deployment/Delivery (CD)**
are development practices that automate the process of building, testing,
and deploying code.

-   [Running TYPO3 in production environments](https://docs.typo3.org/permalink/t3coreapi:administation-production@main)
-   [Backup strategies](https://docs.typo3.org/permalink/t3coreapi:administration-backups@main)
-   [Security considerations for administrators](https://docs.typo3.org/permalink/t3coreapi:administration-security@main)
-   [Using Docker in production](https://docs.typo3.org/permalink/t3coreapi:docker-production@main)

**[Running TYPO3 in Docker](https://docs.typo3.org/permalink/t3coreapi:docker-deployment@main)**

Learn how to run TYPO3 using Docker containers for local development and testing,
including step-by-step guides for plain Docker, Docker Compose, and DDEV.