# Neos CMS

> Modern PHP CMS with inline editing and content repository.

- Category: CMS & Blogging
- Difficulty: intermediate
- Components: neos, mariadb
- Tags: neos, php, inline-editing, modern
- Source: https://docker.recipes/cms/neos-cms

## Overview

Neos is a next-generation content management system built on the Flow PHP framework, designed from the ground up to provide true inline editing capabilities and a flexible content repository architecture. Unlike traditional CMSes that separate content editing from content presentation, Neos allows editors to modify content directly on the live page through its innovative Fusion rendering engine and node-based content structure. This modern approach eliminates the back-and-forth between preview and edit modes that plague conventional content management workflows.

This stack combines Neos with MariaDB to create a robust content management platform that leverages MariaDB's enhanced storage engines and improved performance characteristics over standard MySQL. MariaDB's Aria storage engine provides crash-safe tables with better caching, while its advanced indexing capabilities handle Neos's hierarchical content repository structure more efficiently. The combination addresses the complex database requirements of Neos's node-based content architecture while maintaining compatibility with PHP applications.

Content creators, digital agencies, and organizations requiring sophisticated content workflows will find this stack particularly valuable. The inline editing capabilities make Neos ideal for teams where non-technical editors need direct control over content presentation, while developers benefit from the powerful Fusion templating system and Flow framework's dependency injection and aspect-oriented programming features.

## Features

- True inline editing with live content manipulation directly on rendered pages
- Content Repository with hierarchical node structure for flexible content organization
- Fusion rendering engine providing declarative templating with prototype inheritance
- Flow framework foundation with dependency injection and aspect-oriented programming
- MariaDB Aria storage engine for crash-safe tables and enhanced caching performance
- Multi-dimensional content with automatic workspace handling for drafts and publications
- Content dimensions for multilingual and multi-variant content management
- Eel expression language for dynamic content processing and transformations

## Use cases

- Corporate websites requiring non-technical editors to update content without developer intervention
- Digital marketing agencies managing multiple client sites with complex content workflows
- Multi-brand organizations needing content dimensions for different markets and languages
- Educational institutions requiring collaborative content creation with inline editing
- E-commerce platforms needing flexible product content management beyond simple catalogs
- Publishing companies managing editorial workflows with workspace-based content staging
- Enterprise intranets where business users need direct content control with approval processes

## Prerequisites

- Minimum 1GB RAM available for MariaDB optimal performance and Neos content processing
- Port 8080 available for Neos web interface and content delivery
- Basic understanding of PHP application deployment and configuration management
- Familiarity with content management concepts and editorial workflows
- Docker and Docker Compose installed with sufficient storage for content and database volumes
- Understanding of environment variable configuration for database credentials

## docker-compose.yml

```yaml
services:
  neos:
    image: neos/neos:latest
    container_name: neos
    restart: unless-stopped
    environment:
      NEOS_DB_HOST: mariadb
      NEOS_DB_NAME: neos
      NEOS_DB_USER: neos
      NEOS_DB_PASSWORD: ${DB_PASSWORD}
    volumes:
      - neos_data:/data
    ports:
      - "8080:8080"
    depends_on:
      - mariadb
    networks:
      - neos-network

  mariadb:
    image: mariadb:11
    container_name: neos-mariadb
    environment:
      MYSQL_ROOT_PASSWORD: ${ROOT_PASSWORD}
      MYSQL_DATABASE: neos
      MYSQL_USER: neos
      MYSQL_PASSWORD: ${DB_PASSWORD}
    volumes:
      - mariadb_data:/var/lib/mysql
    networks:
      - neos-network

volumes:
  neos_data:
  mariadb_data:

networks:
  neos-network:
    driver: bridge
```

## .env

```bash
DB_PASSWORD=changeme
ROOT_PASSWORD=changeme
```

## Usage notes

- Docs: https://docs.neos.io/
- Access at http://localhost:8080, backend at /neos
- True inline editing: edit content directly on page
- Content Repository: node-based content structure
- Fusion rendering: powerful template engine
- Flow framework foundation, modern PHP 8+ architecture

## Troubleshooting

- Neos shows database connection errors: Verify MariaDB container is fully started and NEOS_DB_* environment variables match MYSQL_* database configuration
- Inline editing interface not loading: Check that Neos container has proper write permissions to /data volume and Flow cache can be written
- Content Repository initialization fails: Ensure MariaDB has sufficient memory allocated and InnoDB buffer pool is properly configured for node hierarchy queries
- Fusion rendering errors with prototypes: Verify Neos cache is cleared and Flow framework has detected all package configurations properly
- MariaDB performance issues with content queries: Check that Aria storage engine is enabled and adjust query_cache_size for hierarchical content lookups

