Deploying REDAXO

Introduction

REDAXO is a flexible, open-source content management system from Germany that emphasizes developer freedom and a modular architecture. Unlike rigid CMS platforms, REDAXO provides a blank canvas approach where developers build exactly what they need using AddOns (plugins) and custom templates.

Key features of REDAXO include:

Modular Architecture: Extend functionality through AddOns
Developer Freedom: No enforced structure or templates
Multi-Language Support: Built-in internationalization features
Media Manager: Powerful image processing and media handling
User Management: Flexible permissions and role-based access
YForm: Integrated form and database management
SEO Friendly: Clean URLs and meta tag management
Version Control Ready: File-based configuration works with Git
Active Community: Strong German-speaking community with extensive AddOns

This guide walks through deploying REDAXO on Klutch.sh using Docker, configuring the database, and setting up your content management system.

Prerequisites

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

A Klutch.sh account
A GitHub account with a repository for your REDAXO configuration
A MySQL or MariaDB database
Basic familiarity with Docker and PHP applications

Deploying REDAXO on Klutch.sh

Create Your Dockerfile

Create a Dockerfile in your repository:

FROM php:8.2-apache

# Install system dependencies
RUN apt-get update && apt-get install -y \
    libpng-dev \
    libjpeg-dev \
    libfreetype6-dev \
    libzip-dev \
    libicu-dev \
    unzip \
    curl \
    && rm -rf /var/lib/apt/lists/*

# Configure and install PHP extensions
RUN docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) \
    gd \
    mysqli \
    pdo_mysql \
    zip \
    intl \
    opcache

# Enable Apache modules
RUN a2enmod rewrite headers

# Download REDAXO
WORKDIR /var/www/html
RUN curl -L https://github.com/redaxo/redaxo/releases/latest/download/redaxo.zip -o redaxo.zip \
    && unzip redaxo.zip \
    && rm redaxo.zip

# Set permissions
RUN chown -R www-data:www-data /var/www/html \
    && chmod -R 755 /var/www/html

# Configure PHP for REDAXO
RUN echo "memory_limit = 256M" > /usr/local/etc/php/conf.d/redaxo.ini \
    && echo "upload_max_filesize = 50M" >> /usr/local/etc/php/conf.d/redaxo.ini \
    && echo "post_max_size = 50M" >> /usr/local/etc/php/conf.d/redaxo.ini \
    && echo "max_execution_time = 300" >> /usr/local/etc/php/conf.d/redaxo.ini

EXPOSE 80

CMD ["apache2-foreground"]

Push Your Repository to GitHub

Commit and push your Dockerfile to your GitHub repository.

Create a New Project on Klutch.sh

Navigate to the Klutch.sh dashboard and create a new project named “redaxo-cms”.

Create a New App

Create a new app within your project 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:

Variable	Value
`DB_HOST`	Your database host
`DB_NAME`	`redaxo`
`DB_USER`	Your database username
`DB_PASSWORD`	Your database password

Attach Persistent Volumes

Add persistent storage:

Mount Path	Recommended Size	Purpose
`/var/www/html/media`	20 GB	Uploaded media files
`/var/www/html/redaxo/data`	5 GB	Data and cache
`/var/www/html/redaxo/src/addons`	2 GB	Installed AddOns

Deploy Your Application

Click Deploy to build and start your REDAXO instance.

Complete Installation

Access https://your-app-name.klutch.sh/redaxo/ to complete the web-based installation wizard.

Essential AddOns

After installation, consider installing these popular AddOns:

YForm: Database tables and form management
YRewrite: SEO-friendly URLs
Media Manager: Advanced image processing
Developer: File synchronization for templates
Sprog: Advanced translation management

Additional Resources

Conclusion

Deploying REDAXO on Klutch.sh provides a flexible, developer-friendly CMS with automatic builds, persistent storage, and secure HTTPS access. Build custom websites with complete control over structure and design using REDAXO’s modular architecture.