gylfirst / docker-grav

Custom Docker Image for Grav (prefer official one)

See Official Repository

Custom Docker Image for Grav

This currently is pretty minimal and uses:

• apache-2.4.57
• GD library
• Unzip library
• php8.3
• php8.3-opcache
• php8.3-acpu
• php8.3-yaml
• cron
• vim editor
• wget

It has Open Publishing Space skeleton and admin panel included. You can change the version used with the build args.

I will try to keep this to the latest version by default.

Persisting data

To save the Grav site data to the host file system (so that it persists even after the container has been removed), simply map the container's /var/www/html directory to a named Docker volume or to a directory on the host.

If the mapped directory or named volume is empty, it will be automatically populated with a fresh install of Grav the first time that the container starts. However, once the directory/volume has been populated, the data will persist and will not be overwritten the next time the container starts.

Building the image from Dockerfile

docker build --build-arg GRAV_SKELETON_VERSION=tag -t grav:latest .

Running Grav Image with Latest Grav + Admin:

docker run -p 8000:80 grav:latest

Point browser to http://localhost:8000 and create user account...

Running Grav Image with Latest Grav + Admin with a named volume (can be used in production)

docker run -d -p 8000:80 --restart always -v grav_data:/var/www/html grav:latest

Running Grav Image with docker-compose and a volume mapped to a local directory

Running docker-compose up -d with the following docker-compose configuration will automatically build the Grav image (if the Dockerfile is in the same directory as the docker-compose.yml file). Then the Grav container will be started with all of the site data persisted to a named volume (stored in the ./grav directory).

volumes:
  grav-data:
    driver: local
    driver_opts:
      type: none
      device: $PWD/grav
      o: bind

services:
  grav:
    build: 
      context: ./
      args: 
        GRAV_SKELETON_VERSION: tag
    ports:
      - 8000:80
    volumes:
      - grav-data:/var/www/html