A lightweight and secure Omeka S setup for Docker, built on Alpine Linux. This image is optimized for performance and size, making it an ideal choice for development and production environments.

Repository: https://github.com/erseco/alpine-omeka-s

• Lightweight: Built on the erseco/alpine-php-webserver base image for a minimal footprint (+/- 70MB).
• Performant: Uses PHP-FPM with an ondemand process manager to optimize resource usage.
• Secure: Services run under a non-privileged user (nobody). Logs are directed to the container's STDOUT.
• Multi-Arch Support: amd64, arm/v6, arm/v7, arm64, ppc64le, s390x.
• Configurable: Easily configure the container using environment variables.
• Extensible: Automatically install themes and modules on startup.
• Simple & Transparent: Follows the KISS principle for easy understanding and customization.

Here is a minimal docker-compose.yml example to get you started:

---
services:
  mariadb:
    image: mariadb:lts
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=omeka_s
      - MYSQL_DATABASE=omeka_s
      - MYSQL_USER=omeka_s
      - MYSQL_PASSWORD=omeka_s
    volumes:
      - mariadb_data:/var/lib/mysql

  omeka-s:
    image: erseco/alpine-omeka-s:latest
    build:
      context: .
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      # Omeka S Installation Details
      OMEKA_ADMIN_EMAIL: admin@example.com
      OMEKA_ADMIN_PASSWORD: PLEASE_CHANGEME
      OMEKA_SITE_TITLE: "My Omeka S Site"
      # Database Connection
      DB_HOST: mariadb
      DB_NAME: omeka_s
      DB_USER: omeka_s
      DB_PASSWORD: omeka_s
    volumes:
      - omeka_data:/var/www/html/volume
    depends_on:
      - mariadb

volumes:
  mariadb_data: null
  omeka_data: null

To start the services, run:

docker compose up

Once the container is running, Omeka S will be installed and accessible at http://localhost:8080.

You can configure the container using the following environment variables in your docker-compose.yml file.

Note: The Omeka S installation will only run if OMEKA_ADMIN_EMAIL, OMEKA_ADMIN_PASSWORD, and OMEKA_SITE_TITLE are all set.

You can automatically install modules and themes by providing space-separated URLs in the OMEKA_MODULES and OMEKA_THEMES environment variables. Both direct .zip file URLs and GitHub repository URLs are supported.

environment:
  OMEKA_THEMES: "https://github.com/omeka-s-themes/default"
  OMEKA_MODULES: |
    https://github.com/Daniel-KM/Omeka-S-module-Common
    https://github.com/Daniel-KM/Omeka-S-module-EasyAdmin

After changing the version, rebuild the image:

docker compose build omeka-s

If you need to run commands as root inside the container (e.g., to install system packages), use docker compose exec:

docker compose exec --user root omeka-s sh