Kopage Docker

Docker image for running Kopage CMS with PHP 8.2, Apache, and ionCube Loader.

Features

• PHP 8.2 with Apache
• ionCube Loader support
• Multi-architecture: linux/amd64 and linux/arm64
• Production-ready PHP configuration (4GB memory limit, optimized for video uploads)
• Auto-installation: Kopage installer automatically extracted on first run
• Performance optimizations: OPcache, compression, browser caching
• Proxy-ready: RemoteIP configuration for proper client IP detection behind reverse proxies

Quick Start

docker run -d \
  -p 8080:80 \
  -v kopage-data:/var/www/html \
  crypt010/kopage:latest

Visit http://localhost:8080/install_izkopage-setup.php to complete the Kopage installation.

Configuration

Environment Variables

• SERVER_NAME - Optional Apache ServerName configuration
• PHP_SESSION_COOKIE_SECURE - Controls secure cookie setting for sessions. Default is 1 (HTTPS required). Set to 0 for localhost HTTP testing.

Volume

Mount /var/www/html to persist your Kopage installation:

docker run -d \
  -p 8080:80 \
  -e SERVER_NAME="mysite.com" \
  -v /path/to/kopage:/var/www/html \
  crypt010/kopage:latest

Building

A GitHub Action rebuilds and pushes crypt010/kopage:latest every Monday at 03:00 UTC (and on pushes to main that touch the Dockerfile or entrypoint), pulling the freshest base image and Debian security updates. Each build is smoke-tested (extensions, ionCube, Apache config, HTTP + Brotli check) before it is pushed. It requires the DOCKERHUB_USERNAME and DOCKERHUB_TOKEN repository secrets.

For local builds, use the interactive build script:

./build-and-push.sh

Or build manually:

docker buildx build \
  --pull \
  --build-arg APT_CACHE_BUSTER="$(date -u +%Y%m%d%H%M%S)" \
  --platform linux/amd64,linux/arm64 \
  -t crypt010/kopage:latest \
  .

Note: Only the latest tag is published, and it always contains the current Kopage release plus the latest Debian security updates. There is no version to choose or pass in — the installer is fetched from a static URL that always serves the newest release, so the image carries no version label and nothing here should hardcode one.

IMAGE_MANIFEST.md records what the currently published image actually contains — image and base image digests, PHP and ionCube versions, the Kopage installer version and checksum, and the full Debian package list. CI regenerates and commits it on every build, so the weekly package updates are visible in this repo's history.

IMAGE_MANIFEST.md records what the currently published image contains — base image digest, PHP and ionCube versions, and the full Debian package list. CI regenerates and commits it on every build, so the weekly package updates are visible in this repo's history.

PHP Configuration

• Memory limit: 4GB
• Max upload size: 2GB
• Max execution time: 600 seconds
• OPcache enabled with production settings

License

This Docker image is provided as-is. Kopage CMS has its own licensing terms.