jkibbee/website-app repository overview

⁠website-app

A Debian-based Docker image with Apache, PHP, and PDO MySQL support for running PHP web applications.

⁠What's Included

• Debian Linux (latest stable)
• Apache HTTP Server (2.4+)
• PHP with CLI and MySQL PDO support
• PHP Extensions: php-xml, php-pdo, php-pdo-mysql, php-mysql
• Security: Package vulnerability scanning and updates applied during build

⁠Quick Start

⁠Docker Run

docker run -d \
  -p 8085:80 \
  --name website-app \
  jkibbee/website-app:latest

Then visit: http://localhost:8085

⁠Docker Compose

version: '3.8'

services:
  php-server:
    image: jkibbee/website-app:latest
    container_name: website-app
    ports:
      - "8085:80"
    volumes:
      - ./html:/var/www/html
    restart: unless-stopped

Run with:

docker compose up -d

⁠With Local Files

Mount your PHP files into the container's /var/www/html:

docker run -d \
  -p 8085:80 \
  -v /path/to/your/html:/var/www/html \
  --name website-app \
  jkibbee/website-app:latest

⁠Configuration

⁠Port Mapping

• Container: Port 80 (HTTP)
• Host: Port 8085 (or configure as needed)

Change the host port in docker-compose or docker run:

docker run -p 8085:80 jkibbee/website-app:latest

⁠Volume Mounting

Mount your application files to /var/www/html:

volumes:
  - ./your-app:/var/www/html

⁠Apache ServerName

To suppress the Apache Could not reliably determine the server's FQDN warning, add to your Apache .htaccess or container config:

ServerName localhost

⁠Use Cases

• ✅ PHP web applications with MySQL database connectivity
• ✅ Legacy PHP sites needing SimpleXML parsing
• ✅ Development and testing environments
• ✅ Docker Compose multi-service setups
• ✅ ZimaOS, Portainer, or other container platforms

⁠PHP Features

The image includes:

• PDO for database abstraction
• mysqli for MySQL connections
• SimpleXML for XML processing
• php-cli for command-line PHP scripts

Check installed extensions:

docker run jkibbee/website-app:latest php -m

⁠Troubleshooting

⁠Container exits immediately

• Check logs: docker logs website-app
• Verify /var/www/html is not empty or has valid PHP
• Ensure port 80 is not already mapped

⁠500 Internal Server Error

• Check PHP error logs: docker exec website-app tail -f /var/log/apache2/error.log
• Verify PHP extensions are loaded: docker exec website-app php -m
• Check file permissions in mounted volume

⁠Permission Denied

• Ensure mounted file ownership allows Apache (uid 33)
• Linux: sudo chown -R 33:33 ./html
• macOS/Windows: Usually handled automatically by Docker Desktop

⁠Image not found on ZimaOS or Portainer

• Pull manually: docker pull jkibbee/website-app:latest
• Verify Docker Hub access / internet connectivity
• Use correct image name: jkibbee/website-app:latest (with username)

⁠Supported Platforms

• ✅ Docker Desktop (macOS, Windows)
• ✅ Linux (Docker Engine)
• ✅ ZimaOS (via Docker Compose or Portainer)
• ✅ Kubernetes (with proper configuration)

⁠Building Locally

If you want to customize the image:

git clone <your-repo>
cd website-app
docker build -t my-website-app:latest .

⁠License

Specify your license here (e.g., MIT, Apache 2.0)

⁠Support

Found an issue? Have questions?

• Check the troubleshooting section above
• Review Docker/Apache/PHP documentation
• Check the image build logs for dependency issues

Maintained by: jkibbee
Last Updated: April 2026
Docker Hub: jkibbee/website-app⁠