Skip to content

About omeka-s411-docker. This will deploy three Docker containers: Container 1 as mariadb (mysql); Container 2 as phpmyadmin (connected to container 1); and, Container 3: omeka-s411 (connected to container 1)

Notifications You must be signed in to change notification settings

spatialscientist/omeka-s411-docker

Repository files navigation

Omeka-S411 in Docker containers. S411 stands for Omeka S version 4.1.1

This repository contains Docker containers, and additional files, to help you run an Omeka S version 4.1.1 instance. There are options to either use Github Codespaces (the simplest) or launch/build the containers using local Visual Studio Code (VSCode) setup or via command line only.

Launch the containers using Github Codespaces

  • Fork this repository

    Fork github repository

  • Go to '<> Code' section on your forked repository -> Codespaces -> select 'Create codespace on main'. This will launch a codespace with Visual Studio Code (VSCode) interface if successful

    Create codespace on main

  • Install 'Docker' extension.

    • Open the "docker-compose.yml" file. Be alert here as you may get an alert asking you "Do you want to install the recommended 'Docker' extension from Microsoft for docker-composer.yml?" Click the install button to install. For the first time, the installation may take a while so you need patience.

      install the recommended 'Docker' extension

    • Go to "Extensions" section to manually install 'Docker' extension if you do not see the alert.

      install the recommended 'Docker' extension

  • Right-click "docker-compose.yml" file and select 'Compose up'. For the first time, the building may take a while so you need patience.

    select 'Compose up'

  • Hurray! If everything works as expected, you just click 'Open in Browser' button to go to Omeka S 4.1.1 for further details to set it up.

    Open in Browser

  • Fill in the form to setup your Omeka S 4.1.1 instance.

    Omeka S 4.1.1 instance

  • Note that as part of this setup, there are:

    • Two modules installed made up of the Common module and the EasyAdmin module. The "Common" module needs to be installed first before installing the "EasyAdmin" module.
    • Go to the "Module" section to install the two modules.
    • Importance of EasyAdmin module: This module will allow you to install additional Omeka S themes and or modules.
    • One default theme installed

    Install modules

Launch the containers using VSCode

  • Install VSCode and docker extensions.
  • Launch/open VSCode or learn how to use VSCode here.
  • Clone this repository using VSCode. Learn how to clone and use a GitHub repository in Visual Studio Code.
  • Go to VSCode Explorer. You may use "Ctrl + Shift + E" on windows keyboard.
  • Option A (If you don't want to build a docker image using the Dockerfile)
    • Right-click "docker-compose.yml" and select "Compose Up". Alternatively, you can use the terminal: docker compose -f "docker-compose.yml" up -d --build
  • Option B (if you want to build a docker image using the Dockerfile)
    • Right-click on Dockerfile and select "build image".
    • Enter "omekaS411docker:latest" as the image name. Note that this name is used in the docker-compose.yml file.
    • Press enter to build the docker image.
    • Right-click "docker-compose.yml" and select "Compose Up". Alternatively, you can use the terminal: docker compose -f "docker-compose.yml" up -d --build
  • Go to your browser and type "localhost" for the OmekaS411 instance website or use "localhost:8080" for the phpmyadmin interface to manage MySQL database.

Launch the containers using command line

Install Docker and Docker-compose on your host (can be a physical or virtual machine).

Download the file "docker-compose.yml".

From the directory containing the "docker-compose.yml" file:

$ docker-compose up -d

OR

$ sudo docker-compose up -d

OR

$ docker compose -f "docker-compose.yml" up -d --build

This will deploy three Docker containers:

  • Container 1: mariadb (mysql)
  • Container 2: phpmyadmin (connected to container 1)
  • Container 3: omeka-S411 (connected to container 1)

Some useful themes and modules for Omeka S are also added. Additional modules could be installed using the EasyInstall module.

With your browser, go to:

At that point, you can start configuring your Omeka-S web portal.

Remarks:

  • images will be downloaded automatically from the Docker hub: 67911151/omekaS411docker:latest, mariadb:latest, phpmyadmin:latest. You may also choose to build the docker image for Omeka S 411 using the name "omekaS411docker:latest" instead of using the image on Docker hub.
  • for the omeka-s container, /var/www/html/files (media files uploaded by the users) and /var/www/html/config/database.ini (configuration file with the credentials for the db) are put in a named volume and will survive the removal of the container. The mariadb container also puts the data (omeka-s db in /var/lib/mysql) in a named volume. Volumes are hosted in the host filesystem (/var/lib/docker/volumes).

To stop the containers:

$ docker-compose stop

OR

$ sudo docker-compose stop

To remove the containers:

$ docker-compose rm 

OR

$ sudo docker-compose rm 

Remark: this will NOT delete the volumes (omeka and mariadb). If you launch again "sudo docker-compose up -d", the volumes will be re-used.

To login into a container:

$ sudo docker container exec -it <container-id-or-name> bash 

Build a new image (optional)

If you want to modify the omeka-s image (by changing the Dockerfile file), you will need to build a new image:

E.g.:

$ git clone https://github.com/spatialscientist/omeka-S411-docker.git
$ cd omeka-S411-docker

Edit the Dockerfile file.

Once done, build the new Docker image:

$ sudo docker image build -t foo/omekaS411docker:1.0.1-bar .
$ sudo docker image tag foo/omeka-s:1.0.1-bar foo/omekaS411docker:latest

Upload the image to your Docker hub repository:

Login in your account (e.g. foo) on hub.docker.com, and create a repository "omeka-S411", then upload your customized image:

$ sudo docker login --username=foo
$ sudo docker image push foo/omekaS411docker:1.0.1-bar
$ sudo docker image push foo/omekaS411docker:latest

About

About omeka-s411-docker. This will deploy three Docker containers: Container 1 as mariadb (mysql); Container 2 as phpmyadmin (connected to container 1); and, Container 3: omeka-s411 (connected to container 1)

Resources

Stars

Watchers

Forks

Packages

No packages published