ProcessWire CMS

Key Features

• jQuery-like $pages API for intuitive content querying with selectors like $pages->find('template=blog-post, date>2024-01-01')
• Fields and Templates architecture allowing custom content types without database schema changes
• ProcessWire's built-in image manipulation and automatic resizing with API-driven asset management
• MySQL 8.0's JSON field support for storing ProcessWire's flexible field configurations and metadata
• Full programmatic control over HTML output with no enforced markup or CSS frameworks
• ProcessWire's multi-language support with MySQL's UTF8MB4 character set for global content
• Built-in user management and permissions system with role-based access control
• MySQL's InnoDB storage engine providing ACID compliance for ProcessWire's page tree operations

Common Use Cases

• 1Custom client websites for web agencies requiring unique designs and content structures
• 2Corporate websites with complex content hierarchies and multiple content types
• 3Portfolio and showcase sites for creative professionals needing full design control
• 4Multi-language business websites leveraging ProcessWire's internationalization features
• 5Content-heavy applications like documentation sites or knowledge bases with powerful search
• 6Rapid prototyping of content-driven web applications with custom APIs
• 7Migration target for sites outgrowing WordPress or needing more developer flexibility

Prerequisites

• Docker and Docker Compose installed with at least 1GB RAM available for MySQL
• Basic PHP knowledge and familiarity with object-oriented programming concepts
• Understanding of web development fundamentals including HTML, CSS, and MySQL
• Port 80 available on host system for ProcessWire web interface access
• Environment variables configured for ROOT_PASSWORD and DB_PASSWORD
• Familiarity with ProcessWire's fields and templates concept for content modeling

docker-compose.yml

1services: 
2  processwire: 
3    image: processwire/processwire:latest
4    container_name: processwire
5    restart: unless-stopped
6    volumes: 
7      - ./site:/var/www/html
8    ports: 
9      - "80:80"
10    depends_on: 
11      - mysql
12    networks: 
13      - processwire-network
14
15  mysql: 
16    image: mysql:8.0
17    container_name: processwire-mysql
18    environment: 
19      MYSQL_ROOT_PASSWORD: ${ROOT_PASSWORD}
20      MYSQL_DATABASE: processwire
21      MYSQL_USER: processwire
22      MYSQL_PASSWORD: ${DB_PASSWORD}
23    volumes: 
24      - mysql_data:/var/lib/mysql
25    networks: 
26      - processwire-network
27
28volumes: 
29  mysql_data: 
30
31networks: 
32  processwire-network: 
33    driver: bridge

.env Template

1DB_PASSWORD=changeme
2ROOT_PASSWORD=changeme

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

processwire:
  image: processwire/processwire:latest
  container_name: processwire
  restart: unless-stopped
  volumes:
    - ./site:/var/www/html
  ports:
    - "80:80"
  depends_on:
    - mysql
  networks:
    - processwire-network

mysql:
  image: mysql:8.0
  container_name: processwire-mysql
  environment:
    MYSQL_ROOT_PASSWORD: ${ROOT_PASSWORD}
    MYSQL_DATABASE: processwire
    MYSQL_USER: processwire
    MYSQL_PASSWORD: ${DB_PASSWORD}
  volumes:
    - mysql_data:/var/lib/mysql
  networks:
    - processwire-network

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  processwire:
5    image: processwire/processwire:latest
6    container_name: processwire
7    restart: unless-stopped
8    volumes:
9      - ./site:/var/www/html
10    ports:
11      - "80:80"
12    depends_on:
13      - mysql
14    networks:
15      - processwire-network
16
17  mysql:
18    image: mysql:8.0
19    container_name: processwire-mysql
20    environment:
21      MYSQL_ROOT_PASSWORD: ${ROOT_PASSWORD}
22      MYSQL_DATABASE: processwire
23      MYSQL_USER: processwire
24      MYSQL_PASSWORD: ${DB_PASSWORD}
25    volumes:
26      - mysql_data:/var/lib/mysql
27    networks:
28      - processwire-network
29
30volumes:
31  mysql_data:
32
33networks:
34  processwire-network:
35    driver: bridge
36EOF
37
38# 2. Create the .env file
39cat > .env << 'EOF'
40DB_PASSWORD=changeme
41ROOT_PASSWORD=changeme
42EOF
43
44# 3. Start the services
45docker compose up -d
46
47# 4. View logs
48docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/processwire/run | bash

Troubleshooting