Skip to content
Klutch.sh Docs

Deploying TYPO3

Introduction

TYPO3 is a professional, enterprise-grade content management system with a long history of powering websites of all sizes. Known for its flexibility, security, and scalability, TYPO3 is particularly popular in Europe and trusted by governments, universities, and large corporations.

Key highlights of TYPO3:

  • Enterprise Ready: Built for large-scale, mission-critical websites
  • Multi-Site Support: Manage multiple websites from a single installation
  • Multi-Language: Built-in support for multilingual content
  • Flexible Content: Powerful content modeling with custom elements
  • User Permissions: Granular access control for editors and administrators
  • Extension System: Thousands of extensions available
  • Workflow Support: Content staging and approval workflows
  • SEO Friendly: Built-in SEO optimization tools
  • GDPR Compliant: Privacy-focused features
  • LTS Releases: Long-term support versions for stability

This guide walks through deploying TYPO3 on Klutch.sh using Docker.

Why Deploy TYPO3 on Klutch.sh

Deploying TYPO3 on Klutch.sh provides several advantages:

Simplified Deployment: Klutch.sh automatically detects your Dockerfile and builds TYPO3 without complex orchestration.

Persistent Storage: Attach persistent volumes for uploads, extensions, and configuration.

HTTPS by Default: Secure your CMS with automatic SSL certificates.

GitHub Integration: Connect your configuration repository for automatic redeployments.

Prerequisites

Before deploying TYPO3 on Klutch.sh, ensure you have:

  • A Klutch.sh account
  • A GitHub account with a repository for your TYPO3 configuration
  • Basic familiarity with Docker and containerization concepts
  • A MySQL or PostgreSQL database

Deploying TYPO3 on Klutch.sh

    Create Your Repository

    Create a new GitHub repository with a Dockerfile for TYPO3:

    FROM martinhelmich/typo3:12
    

    ENV TYPO3_CONTEXT=Production
    ENV TYPO3_DB_HOST=${DB_HOST}
    ENV TYPO3_DB_NAME=${DB_NAME}
    ENV TYPO3_DB_USER=${DB_USER}
    ENV TYPO3_DB_PASSWORD=${DB_PASSWORD}
    

    EXPOSE 80
    

    VOLUME ["/var/www/html/fileadmin", "/var/www/html/typo3conf", "/var/www/html/uploads"]

    Push to GitHub

    Initialize and push your repository to GitHub with your Dockerfile.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project.

    Create a New App

    Within your project, create a new app and connect your GitHub repository.

    Configure HTTP Traffic

    In the deployment settings:

    • Select HTTP as the traffic type
    • Set the internal port to 80

    Set Environment Variables

    Configure the following environment variables:

    VariableValue
    TYPO3_CONTEXTProduction
    DB_HOSTYour database hostname
    DB_NAMEYour database name
    DB_USERYour database username
    DB_PASSWORDYour database password

    Attach Persistent Volumes

    Add the following volumes:

    Mount PathRecommended SizePurpose
    /var/www/html/fileadmin50 GBUploaded files and assets
    /var/www/html/typo3conf5 GBConfiguration and extensions
    /var/www/html/uploads10 GBLegacy upload directory

    Deploy Your Application

    Click Deploy to start the build process.

    Access TYPO3

    Once deployment completes, run the installation wizard at https://your-app.klutch.sh/typo3/install.php.

Configuration

Installation Wizard

Complete the installation:

  1. Navigate to /typo3/install.php
  2. Enter your database credentials
  3. Create an admin user
  4. Complete the setup process

Backend Access

Access the TYPO3 backend at /typo3:

  • Manage pages and content
  • Configure site settings
  • Install extensions
  • Manage users and permissions

Installing Extensions

Install extensions via the Extension Manager:

  1. Navigate to Admin Tools > Extensions
  2. Search for extensions in TER (TYPO3 Extension Repository)
  3. Click Install on desired extensions

Multi-Site Configuration

Configure additional sites:

  1. Navigate to Site Management > Sites
  2. Add a new site configuration
  3. Set base URL and languages
  4. Configure routing and error handling

Additional Resources

Conclusion

Deploying TYPO3 on Klutch.sh gives you an enterprise-grade CMS with automatic builds, persistent storage, and secure HTTPS access. Build professional, scalable websites with one of the most powerful open-source content management systems available.