getgrav/docker-grav

Grav CMS Docker Image

Official Docker image for Grav CMS - a modern, fast, and flexible flat-file content management system.

Supported Tags

• latest, 1.7, php8.3 - Grav with PHP 8.3 (default)
• php8.5 - Grav with PHP 8.5 (latest PHP)
• php8.4 - Grav with PHP 8.4

Quick Start

# Pull and run
docker run -d -p 8080:80 -v grav_site:/var/www/html getgrav/grav

# Open browser
open http://localhost:8080

That's it! Grav will be automatically installed on first run.

With Docker Compose

services:
  grav:
    image: getgrav/grav
    ports:
      - "8080:80"
    volumes:
      - grav_site:/var/www/html
    restart: unless-stopped

volumes:
  grav_site:

docker compose up -d

With Local Directory

# Create a directory for your site
mkdir my-grav-site

# Run with bind mount
docker run -d -p 8080:80 -v ./my-grav-site:/var/www/html getgrav/grav

Features

• Auto-install - Grav is automatically installed on first run if the volume is empty
• Grav Scheduler - Cron job for Grav's scheduler is pre-configured
• Health Check - Built-in health check for container orchestration
• Customizable - Easy to add PHP extensions via build args

Environment Variables

Configuration

Installing Grav Beta

To install the latest Grav 1.8 beta:

docker run -d -p 8080:80 -e GRAV_CHANNEL=beta -v grav_site:/var/www/html getgrav/grav

Or with Docker Compose:

services:
  grav:
    image: getgrav/grav
    environment:
      - GRAV_CHANNEL=beta
    volumes:
      - grav_site:/var/www/html

Using an Existing Grav Site

Mount your existing Grav installation:

docker run -d -p 8080:80 -v /path/to/your/grav:/var/www/html getgrav/grav

The container detects existing installations and skips the auto-install.

Fixing Permissions

If you encounter permission errors:

docker run -d -p 8080:80 \
  -e FIX_PERMISSIONS=true \
  -v ./my-site:/var/www/html \
  getgrav/grav

Or fix manually:

docker exec <container> chown -R www-data:www-data /var/www/html

Building Custom Images

Different PHP Version

# Clone the repository
git clone https://github.com/getgrav/docker-grav.git
cd docker-grav

# Build with PHP 8.4
docker build --build-arg PHP_VERSION=8.4 -t grav:php84 .

Additional PHP Extensions

Default extensions: opcache, intl, gd, zip, apcu, yaml

Add more:

# Add Xdebug for development
docker build --build-arg PHP_EXTRA_EXTENSIONS="xdebug" -t grav:dev .

# Add Redis and Imagick
docker build --build-arg PHP_EXTRA_EXTENSIONS="redis imagick" -t grav:custom .

Specific Grav Version

docker build --build-arg GRAV_VERSION=1.7.45 -t grav:1.7.45 .

Extending the Image

FROM getgrav/grav:latest

# Install additional PHP extensions
RUN install-php-extensions mongodb

# Copy custom configuration
COPY my-config.yaml /var/www/html/user/config/system.yaml

Development Setup

With Xdebug

services:
  grav:
    build:
      context: .
      args:
        PHP_EXTRA_EXTENSIONS: xdebug
    ports:
      - "8080:80"
    volumes:
      - ./site:/var/www/html
    environment:
      - XDEBUG_MODE=debug
      - XDEBUG_CONFIG=client_host=host.docker.internal

Custom Initialization Scripts

Add scripts to /docker-entrypoint.d/ to run before Apache starts:

FROM getgrav/grav:latest
COPY my-init.sh /docker-entrypoint.d/
RUN chmod +x /docker-entrypoint.d/my-init.sh

Production Deployment

Basic Setup

services:
  grav:
    image: getgrav/grav
    ports:
      - "80:80"
    volumes:
      - grav_data:/var/www/html
    restart: always

volumes:
  grav_data:

With Traefik Reverse Proxy

services:
  grav:
    image: getgrav/grav
    volumes:
      - grav_data:/var/www/html
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.grav.rule=Host(`example.com`)"
      - "traefik.http.routers.grav.tls.certresolver=letsencrypt"
    restart: always

volumes:
  grav_data:

Troubleshooting

Checking Logs

# Container logs
docker logs <container>

# Apache error log
docker exec <container> tail -f /var/log/apache2/error.log

# Grav logs
docker exec <container> tail -f /var/www/html/logs/grav.log

Grav CLI

# Clear cache
docker exec <container> bin/grav clearcache

# Install plugins
docker exec <container> bin/gpm install admin

# Check PHP info
docker exec <container> php -i

Health Check

The container includes a health check that polls http://localhost/ every 30 seconds. Check health status:

docker inspect --format='{{.State.Health.Status}}' <container>

License

MIT License - see LICENSE for details.

Links

• Grav Documentation
• Grav GitHub
• Docker Hub
• Report Issues