Install TYPO3 on Debian: A Beginner’s Guide

Install TYPO3 on Debian: A Beginner’s Guide

Debian is renowned for its stability and conservative approach to package updates. If you’re running a production-critical TYPO3 site that needs rock-solid reliability, Debian is an ideal choice.

In this blog, we are diving deep into how to install and configure TYPO3 on Debian — whether you're a developer, sysadmin, or digital agency setting up a secure TYPO3 server. 

Wait ! Before moving further, are you considering launching or hosting your TYPO3 site on another platform? We recommend checking out our TYPO3 Installation Series below for step-by-step guides on various platforms.

Let’s dive in and build a powerful, secure TYPO3 environment — the right way — on Debian.

What is Debian?

Debian is a Unix-like operating system composed entirely of free software, developed and maintained by a global community of volunteers.It uses the Linux kernel (or alternatively the FreeBSD kernel in some variants) and includes a vast repository of precompiled software.

 

TYPO3 is a free, open-source Content Management System (CMS) built to help businesses and organizations create, manage, and grow their websites. It was founded in 1997 by Kasper Skårhøj and has since become one of the most popular CMS platforms—especially across Europe.

TYPO3 is written in PHP and uses TypoScript, a powerful configuration language that allows for advanced customization and flexibility. You don’t need any special software—TYPO3 runs in your browser and outputs content using standard HTML and JavaScript.

Whether you’re running a small business site, a university portal, or a large enterprise website, TYPO3 can scale to fit your needs.

Imagine an enterprise CMS that evolves as your project grows—without piling on complexity. That’s TYPO3 for you! It’s an open-source powerhouse that excels at:

here are the key reasons that TYPO3 Developers, marketers, and agencies trust TYPO3 for its:

  • Modularity: Make your website do exactly what you need. No more, no less.
  • Security & Stability: Regular LTS (Long-Term Support) releases help you stay secure for years.
  • Scalability: From a tiny local site to a massive global platform, TYPO3 can handle it.
  • Community-Driven Development: Enjoy a lively global community that refines and evolves TYPO3 continuously.

Did You Know? TYPO3 powers over 500,000+ active websites around the world! 

Read more TYPO3 Facts.

Why use TYPO3?

TYPO3 offers advanced features like granular user roles, multisite management, and a strong ecosystem of extensions. It’s perfect for businesses and agencies that need scalability and long-term support.

  • Stable Foundation: Debian’s long release cycles mean fewer surprises and consistent performance.
  • Security Updates: The Debian Security Team is known for quick patching of vulnerabilities.
  • Server-Oriented: Many hosting providers default to Debian for its robustness and predictable behavior.0
  • Compatibility: Similar to Ubuntu in commands and workflow, making it easy to adapt tutorials.

Operating System

  • Debian 12 (Bookworm) or Debian 11 (Bullseye) recommended
  • 64-bit architecture

Hardware Requirements

  • Minimum:
    • 1 vCPU
    • 2 GB RAM
    • 10 GB SSD storage
    • 1 GB Swap
  • Recommended:
    • 2+ vCPU
    • 4–8 GB RAM
    • 20+ GB SSD storage with backup setup
    • 2 GB Swap

Web Server

  •    Apache 2.4+ (enable mod_rewrite)or
  •  NGINX 1.18+

PHP Configuration

  • TYPO3 v12: PHP 8.1 / 8.2
  • TYPO3 v13: PHP 8.2 / 8.3

Database

  • MariaDB 10.6+ or
  • MySQL 8.0+

Before diving in, note TYPO3’s release cycles:

  • LTS (Long-Term Support): Typically three years of updates per major release.
  • ELTS (Extended LTS): Paid option if you need extra time beyond standard LTS.

Staying on a currently supported LTS means you’ll get important security patches and feature improvements.

View Roadmap

1. PHP & TYPO3 Compatibility

TYPO3 VersionPHP VersionsStatus
9 ELTS7.2–7.4Active ELTS
10 ELTS7.2–7.4Active ELTS
11 ELTS7.4, 8.0Active ELTS
12 LTS8.1–8.4Active ELTS
13 LTS8.2–8.4Active ELTS

2. System Requirements

  • Web Server: Apache or Nginx
  • Database: MariaDB/MySQL recommended
  • Composer: Recommended for a smoother TYPO3 experience

Always verify with TYPO3’s official System requirements to ensure you’re up to date.

Diagram Explanation:

  • Composer automates versioning, dependency management, and updates.
  • Classic is manual but sometimes easier on hosts without CLI access.

Step 1. Update & Enable Repos

sudo apt-get update && sudo apt-get upgrade -y

Step 2. Install Apache (or Nginx) + MariaDB

sudo apt-get install apache2 mariadb-server mariadb-client -y
sudo systemctl enable apache2
sudo systemctl start apache2
sudo mysql_secure_installation

Then create your database/user:
sudo mysql -u root -p
CREATE DATABASE typo3db;
CREATE USER 'typo3user'@'localhost' IDENTIFIED BY 'supersecret';
GRANT ALL PRIVILEGES ON typo3db.* TO 'typo3user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 3. PHP & Extensions

sudo apt-get install php php-cli php-mysql php-xml php-gd \
                     php-curl php-zip php-intl php-mbstring -y

Step 4. Download or Composer-Install TYPO3

Composer:

 sudo apt-get install composer -y
cd /var/www/html
sudo composer create-project typo3/cms-base-distribution typo3cms
sudo chown -R www-data:www-data typo3cms

Classic:

  • Download the zip from the official site.
  • Unzip to /var/www/html/typo3cms.
  • sudo chown -R www-data:www-data /var/www/html/typo3cms

Step 5. Apache Virtual Host (Example)

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /var/www/html/typo3cms/public

    <Directory /var/www/html/typo3cms/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/typo3-error.log
    CustomLog ${APACHE_LOG_DIR}/typo3-access.log combined
</VirtualHost>

sudo a2enmod rewrite
sudo systemctl restart apache2

Step 6. Final Steps

Navigate to SERVER_IP or domain, run the TYPO3 Install Wizard:

  • Database: typo3db, user typo3user, password supersecret.
  • Admin user creation.
  • Login to the backend.

Once all server configurations are complete, it’s time to finish the setup through the TYPO3 Installation Wizard. This user-friendly, step-by-step wizard helps you finalize the installation process directly in your browser.

Step 1. Check the System Environment (detect if any issues)

TYPO3 will scan your server for required PHP extensions, folder permissions, and system settings. Fix any issues listed before proceeding,

Step 2. Setup Your Database Credentials

Enter the database name, username, and password you created earlier. TYPO3 will use this to store your content and configurations.

Step 3. Choose an Existing Database or Create a New

Select an existing empty database or let TYPO3 create a new one for you.

Step 4. Create backend user & Site

Set up the backend administrator account. Make sure to choose a secure password—you’ll use this to log into the TYPO3 dashboard.

Step 5. Installation Process Start

Define your site name and initial setup options. You can also choose to load a distribution or start with a blank site.

You did it! Now you have a running TYPO3 site on AWS.

Step 6. Get Start with Backend Login

TYPO3 will complete the setup and redirect you to the backend login page.

Choosing the right environment for your TYPO3 project depends on your technical needs, budget, and scalability plans. Here’s a quick comparison to help you decide:

PlatformBest ForKey BenefitsThings to Consider
Debian (Self-Managed)Developers and sysadminsExtremely stable, secure, minimal bloatRequires manual setup, command-line proficiency
Rocky LinuxDevelopers and system administrators
seeking enterprise-grade stability with full control
Free, stable, secure RHEL-compatible OS.Requires manual setup
 and server management
 experience
Ubuntu (Self-Managed)Developers and teams wanting 
full control and customization
Free, open-source, 
highly flexible,large community support, easy optimization for TYPO3
Requires server management skills
Google Cloud PlatformTeams already using 
Google ecosystem
Easy G Suite integration, powerful analytics tools, scalable infrastructureSlightly higher learning 
curve for beginners
AWS (Amazon Web Services)Scalable production
environments
High availability, global reach, flexible resources, strong securitySlightly higher learning 
curve for beginners
Microsoft AzureEnterprises using Microsoft
technologies
Seamless integration with Windows, Office, Active
 Directory, hybrid cloud
Licensing and costs 
may be higher
Docker / Docker ComposeLocal dev, testing, or 
microservices setups
Lightweight, fast to deploy, reproducible environmentsDocker-savvy, not ideal without orchestration.
Platform.shDevelopers focused on 
CI/CD & automation
Git-based workflows,  automatic scaling, zero-downtime deploymentsLess control over
 underlying infrastructure,
 premium pricing

Debian is a rock-solid foundation for TYPO3, offering stability and ease of management. With the steps above, you’ll have a production-ready TYPO3 environment, ready for further enhancements like SSL, caching, or advanced load balancing.

Happy TYPO3ing on Debian!

Typically the latest stable release (e.g., Debian 11 “Bullseye”) for a balance of modern packages and stability.

Yes, they share the same APT packaging. Most commands are interchangeable.

Some Debian versions require enabling modules (e.g., sudo phpenmod mbstring). Check if each extension is active.

Absolutely. Just install mysql-server in place of mariadb-server.

Modern Debian uses systemd, so commands like systemctl are typical.

Likely file permission issues. Ensure www-data:www-data owns the web root.

Install certbot for Let’s Encrypt and configure Apache for SSL on port 443.

Use UFW or iptables as needed. Keep your system patched with apt-get update && apt-get upgrade.

Yes. Create separate virtual hosts and directories.

With Composer: composer update in your project folder. For classic: replace the core files.

Post a Comment

×