README for omeka_classic

This is a set of Docker images and a Docker swarm workflow for deploying Omeka Classic applications.

Supported Versions

• Omeka Classic v. 2.6

Requirements

• Docker CE 17.12 or higher
• one or more Docker hosts configured as a swarm

Building the Image

To build the image, run the following command from the root of the repository:

docker build -t omeka_classic:latest images/omeka_classic

Note that the latest tag is the tag referred to in the docker-compose.yml file. If you use a different tag, update the docker-compose.yml file to refer to the new tag before attempting a deployment.

Deployment

To deploy, clone this repo and build the image as directed in the previous section. Execute the following commands to create the configuration file and database credentials that will be mapped into the omeka_app and db services as secrets upon deployment:

echo 'your_db_password' | docker secret create omeka_db_password -
echo 'your_db_root_password' | docker secret create omeka_db_root_password -
cp images/omeka_classic/db.ini.example images/omeka_classic/db.ini

Edit the newly created db.ini file to use the database credentials that were passed to docker secret create. Note that username, password, and database in dbi.ini must match MYSQL_USER, MYSQL_PASSWORD, and MYSQL_DATABASE in docker-compose.yml and your omeka_db_password secret, respectively. Execute the following command from the root of the repository to deploy the application to the swarm:

docker stack deploy -c docker-compose.yml omeka_classic

Your application should be available at port 80 in the browser.

Plugins

Omeka applications deployed with this image ship with the following plugins:

• AdminImages
• Annotator
• Blogger
• Blog Shortcode
• Bulk Metadata Editor
• Collection Tree
• Commenting
• CsvExport
• CsvImport
• Derivative Images
• Disqus Engage
• Dublin Core Extended
• Editorial
• Element Types
• Exhibit Image Annotation
• Geolocation
• HideElements
• History Log
• HTML5 Media
• Item Order
• Item Review
• LC Suggest
• Maintenance
• Neatline
• Neatline Time
• Neatline Widget SIMILE Timeline
• Neatline Widget Text
• Neatline Features
• Neatline Waypoints
• PDF Embed
• PDF Text
• Record Relations
• Scripto
• Shortcode Carousel
• Simple Contact Form
• Simple Vocab
• Sitemap
• Social Bookmarking
• Taxonomy
• Timeline Shortcode
• User Profiles

Themes

The omeka_classic image contains two themes featuring Penn Libraries branding, forked from the core Omeka themes Thanks, Roy and Emiglio.