Grav container image running on Alpine Linux

This container image (yobasystems/alpine-grav) is based on the minimal Alpine Linux ready for running Grav (Flat file CMS)

Alpine Version 3.20.2 (Released 2024-07-22)

Grav Version 1.7.46

---

Table of Contents

• What is Alpine Linux?
• Features
• Architectures
• Tags
• Layers & Sizes
• How to use this image
• Image contents & Vulnerability analysis
• Source Repositories
• Container Registries
• Links
• Donation

🏔️ What is Alpine Linux?

Alpine Linux is a Linux distribution built around musl libc and BusyBox. The image is only 5 MB in size and has access to a package repository that is much more complete than other BusyBox based images. This makes Alpine Linux a great image base for utilities and even production applications. Read more about Alpine Linux here and you can see how their mantra fits in right at home with container images.

✨ Features

• Minimal size only, minimal layers
• Memory usage is minimal on a simple install.

🏗️ Architectures

• :amd64, :x86_64 - 64 bit Intel/AMD (x86_64/amd64)
• :arm64v8, :aarch64 - 64 bit ARM (ARMv8/aarch64)
• :arm32v7, :armhf - 32 bit ARM (ARMv7/armhf)

📝 PLEASE CHECK TAGS BELOW FOR SUPPORTED ARCHITECTURES, THE ABOVE IS A LIST OF EXPLANATION

🏷️ Tags

• :latest latest branch based (Automatic Architecture Selection)
• :master master branch usually inline with latest
• :deliver-site deliver-site branch based (Automatic Architecture Selection)
• :one-page one-page branch based (Automatic Architecture Selection)
• :amd64, :x86_64 amd64 based on latest tag but amd64 architecture
• :aarch64, :arm64v8 Armv8 based on latest tag but arm64 architecture
• :armhf, :arm32v7 Armv7 based on latest tag but arm32 architecture

📏 Layers & Sizes

🚀 How to use this image

Environment Variables:

Creating an instance

mkdir -p /data/{domain}/html

docker run -e VIRTUAL_HOST={domain}.com,www.{domain}.com -v /data/{domain}/html:/usr/html -p 80:80 yobasystems/alpine-grav

E.G

mkdir -p /data/yobasystems/html

docker run -e VIRTUAL_HOST=www.yobasystems.co.uk -v /data/yobasystems/html:/usr/html -p 80:80 yobasystems/alpine-grav

Make sure you create the folder on the host before starting the container and obtain the correct permissions.

mkdir -p /data/{domain}/html

docker run -e VIRTUAL_HOST={domain}.com,www.{domain}.com -v /data/{domain}/html:/usr/html -p 80:80 yobasystems/alpine-grav

E.G

mkdir -p /data/yobasystems/html

docker run -e VIRTUAL_HOST=www.yobasystems.co.uk -v /data/yobasystems/html:/usr/html -p 80:80 yobasystems/alpine-grav

The following user and group id are used, the files should be set to this: User ID: Group ID:

chown -R 100:101 /data/{domain}/html

E.G

chown -R 100:101 /data/yobasystems/html

The container image will auto create the folder and populate with files if it doesn't exist. Make sure to mount /data/{domain}/html with your Backup files.

The following user and group id are used, the files should be set to this: User ID: Group ID:

chown -R 100:101 /data/{domain}/html

Volume structure

• /usr/html: Webroot

GRAV CLI GPM

Grav includes a GPM (Grav Package Manager) which allows you to install, update, uninstall and list all the themes and plugins available on the Grav repository, as well as upgrade Grav itself to the latest version. Its best to su nginx before executing anything or else you can potentially compromise your host.

docker exec -it <container_name> bash
su nginx
cd /usr/html
bin/gpm list

Upload limit

The upload limit is 128 Megabytes.

Change php.ini value

modify files/php-fpm.conf

To modify php.ini variable, simply edit php-fpm.ini and add php_flag[variable] = value.

php_flag[display_errors] = on

PHP Modules

List of available modules in Alpine Linux, not all these are installed.

In order to install a php module do, (leave out the version number i.e. -8.1.01-r0

docker exec <image_id> apk add <pkg_name>
docker restart <image_name>

Example:

docker exec <image_id> apk add php83-soap
docker restart <image_name>

php83-common
php83-pdo_sqlite
php83-pear
php83-ftp
php83-imap
php83-mysqli
php83-json
php83-mbstring
php83-soap
php83-litespeed
php83-sockets
php83-bcmath
php83-opcache
php83-dom
php83-zlib
php83-gettext
php83-fpm
php83-intl
php83-openssl
php83-session
php83-pecl-mcrypt
php83-pdo_mysql
php83-embed
php83-xmlrpc
php83-wddx
php83-dba
php83-ldap
php83-xsl
php83-exif
php83-pdo_dblib
php83-bz2
php83-pdo
php83-pspell
php83-sysvmsg
php83-gmp
php83-apache2
php83-pdo_odbc
php83-shmop
php83-ctype
php83-phpdbg
php83-enchant
php83-sysvsem
php83-sqlite3
php83-odbc
php83-pcntl
php83-calendar
php83-xmlreader
php83-snmp
php83-zip
php83-posix
php83-iconv
php83-curl
php83-doc
php83-gd
php83-xml
php83-dev
php83-cgi
php83-sysvshm
php83-pgsql
php83-tidy
php83-pdo_pgsql
php83-phar
php83-mysqlnd

Docker Compose example:

grav:
  image: yobasystems/alpine-grav:latest
  environment:
    VIRTUAL_HOST: www.example.co.uk
  expose:
    - "80"
  volumes:
    - /data/example/www:/usr/html
  restart: always

🔍 Image contents & Vulnerability analysis

PACKAGE NAME	PACKAGE VERSION	VULNERABILITIES

📚 Source Repositories

• Github - yobasystems/alpine-grav

• Gitlab - yobasystems/alpine-grav

• Bitbucket - yobasystems/alpine-grav

🐳 Container Registries

• Dockerhub - yobasystems/alpine-grav

• Quay.io - yobasystems/alpine-grav

🔗 Links

• Yoba Systems

• Github - Yoba Systems

• Dockerhub - Yoba Systems

• Quay.io - Yoba Systems

• Maintainer - Dominic Taylor

💰 Donation