Overview

I summarized how to build Omeka S using Amazon Lightsail in the following article.

This time, I will introduce how to build Omeka Classic using Amazon Lightsail. As described in the following book, Omeka Classic is useful for building annotation environments using the IIIF Toolkit.

https://zenn.dev/nakamura196/books/2a0aa162dcd0eb

Amazon Lightsail

Creating an Instance

Access the following page.

https://lightsail.aws.amazon.com/ls/webapp/home/instances

Then click the “Create Instance” button.

Under “Select a blueprint,” choose “LAMP (PHP 7).”

Under “Choose your instance plan,” select an instance plan. In this case, I chose the lowest-priced plan.

Once launched, access the instance page and click the “Connect using SSH” button.

The following screen will be displayed.

Linux ip-172-26-9-30 4.19.0-20-cloud-amd64 #1 SMP Debian 4.19.235-1 (2022-03-17) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
       ___ _ _                   _
      | _ |_) |_ _ _  __ _ _ __ (_)
      | _ \ |  _| ' \/ _` | '  \| |
      |___/_|\__|_|_|\__,_|_|_|_|_|

  *** Welcome to the LAMP packaged by Bitnami 7.4.29-0                  ***
  *** Documentation:  https://docs.bitnami.com/aws/infrastructure/lamp/ ***
  ***                 https://docs.bitnami.com/aws/                     ***
  *** Bitnami Forums: https://community.bitnami.com/                    ***
bitnami@ip-172-26-9-30:~$

Working Within the Instance

Moving Files

First, download and move the necessary files.

cd .

# Download Omeka
wget https://github.com/omeka/Omeka/releases/download/v3.0.3/omeka-3.0.3.zip
unzip omeka-3.0.3.zip

# Move files
mv omeka-3.0.3/* /home/bitnami/htdocs

# Move .htaccess
mv omeka-3.0.3/.htaccess /home/bitnami/htdocs

# Delete the original index.html
rm /home/bitnami/htdocs/index.html

Creating a Database

Next, create the database.

# Check the password (the password will be displayed)
cat /home/bitnami/bitnami_application_password

# Log into mysql using the above password
mysql -u root -p

# Create a database (the name "omeka" can be changed as desired)
MariaDB [(none)]> create database omeka;
Query OK, 1 row affected (0.002 sec)

MariaDB [(none)]> quit;

Configuring Omeka Classic

Next, modify the Omeka Classic configuration file.

vi /home/bitnami/htdocs/db.ini

Edit the file contents as follows.

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; Database Configuration File ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;
; Omeka requires MySQL 5 or newer.
;
; To configure your database, replace the X's with your specific
; settings. If you're unsure about your database information, ask
; your server administrator, or consult the documentation at
; <http://omeka.org/codex/Database_Configuration_File>.

[database]
host     = "localhost"
username = "root"
password = "(the password you confirmed earlier)"
dbname   = "omeka"
prefix   = "omeka_"
charset  = "utf8"
;port     = ""

Also, change the ownership of the files folder.

sudo chown -R daemon:daemon /home/bitnami/htdocs/files

Additionally, install imagemagick, which is needed for generating thumbnails.

sudo apt install imagemagick -y

Browser Configuration

Access the IP address shown under “Public IP” on the Amazon Lightsail instance page.

The installation screen will be displayed as shown below.

From here, the process is the same as basic Omeka Classic operations. Please refer to the following article for how to use Omeka Classic.

https://zenn.dev/nakamura196/books/2a0aa162dcd0eb/viewer/f17a5b

Custom Domain and More

For “Custom Domain,” “SSL,” and “Basic Authentication,” please refer to the following article.

https://tech.ldas.jp/en/posts/5772d6c918508a/#Custom Domain Setup

Summary

The above summarizes the basic setup of Omeka Classic using Amazon Lightsail.

I hope this serves as a useful reference when building a digital archive system with Omeka Classic.