Omeka S Installer Now Available

We were very excited yesterday to see that the great team at Omeka had rolled out the official 1.0 version of Omeka S (in addition to a gorgeous new website that highlights both S and Classic versions of the software). We’ve been following the project with anticipation for quite awhile now and we know a few users have installed the software manually while it was in the alpha/beta stages. An installer has always been on our radar but we wanted to allow the Omeka team to provide a clear line of support and feedback loop for their product while it was still in beta via their forums (which continue to be a wonderful resource for support of the software with the developers very active there). With the software reaching maturity now and being publicized more widely it was time to make it easy for any Reclaim user to give it a go.

So what is Omeka S? If you’re familiar with Omeka for exhibits and one-off projects you’ll find that Omeka S is a better approach for managing multiple repositories. You have one set of code, plugins (or modules as they’re called now), and themes that are shared across the sites you create. In many ways this will remind you of WordPress Multisite versus standalone WordPress. For institutions or organizations tasked with managing more than one Omeka install this opens the door for an easier workflow. And Omeka has rebuilt their codebase from the ground up.

As of today the installer has begun rolling out to all of our servers (both shared hosting as well as institutional Domain of One’s Own systems). You’ll find installation incredibly straightforward. Simply choose the location you want to install to and fill out a few brief fields setting a name, email, and password and you’re off to the races. Here’s a quick screencast showing what that looks like:

Not ready to run it on your own domain yet? Omeka has provided a sandbox environment for you to play in so you can test the software without setting up any accounts of your own.

We could not be more pleased to continue supporting CHNM and the Omeka team as well as the larger DH community by making this available. Give it a shot and let us know what you think!

Installing Omeka-S Alpha on Reclaim Hosting via Command Line

Early yesterday morning I got two requests to setup Omeka-S for folks on Reclaim Hosting. The first question I asked myself is, “What the hell is Omeka-S?” Thanks to Sharon Leon’s post on the software, I now know:

Omeka S shares an ethos with Omeka Classic(2.x), but none of its code. There are a nice range of features for Omeka S that should make it appealing both to cultural heritage institutions and academic and research libraries, including:

*the ability to administer many sites from a single installation;
*a fully functioning Read/Write REST API, which the system uses to execute most of its own core operations;
*the use of JSON-LD as the native data format, which enmeshes the materials in the LOD universe;
*native RDF vocabularies (DCMI Terms, DCMI Types, FOAF, BIBO);
*and a set of modules to aid integration with Fedora, DSpace, Zotero.

Omeka-S seems to be the next generation of Omeka, and the fact that it has  a multisite feature built-in, as well as REST API functionality and JSON data format is more than promising. The interest amongst Reclaimers yesterday was most likely spurred by this post yesterday on Digital Humanities Now featuring Sheila Brennan’s presentation on Omeka-S at IMLS’s Focus conference in New Orleans.

The good folks at the Roy Rosenzweig  Center for History and New Media have been a constant source of support for us at Reclaim Hosting since the very beginning, and Reclaim never forgets its friends! What’s more, Omeka continues to be one of our most heavily used applications, so it makes good sense that we would try and support folks exploring Omeka-S. That said, it’s still Alpha software, so there is no Installatron installer for it yet.

In order to install Omeka-S I had to do a little commando lining thanks to some tips from Tim “R2D2” Owens. I tried to download and upload the zip file through CPanel’s file manager, and then install the application from there, but that continually failed me.  So, that may not work for folks on Reclaim Hosting. That said,  I can vouch for the following method using terminal/command line.

Note: Before you start the installation, you need to create a database and user for this application. Use the MySQL Database Wizard in CPanel to create a database and be sure to record the username, database name, and password. Also, you should probably create a subdirectory or subdomain that you will install the application in. For the purposes of this tutorial, that subdomain will be called “test.”

First, login to your terminal. You do this using the FTP username and password  you received in the Welcome email from Reclaim Hosting. Once you have them, the login looks like this:

ssh username@yourdomain.com

After that, you will be prompted for the password, be sure to use the FTP password we sent you in Welcome email.

Now you use the following commands to get your application up and running.

Run the following command from inside the folder you created, for this example that will be the directory test.

wget https://github.com/omeka/omeka-s/releases/download/v0.4.0-alpha/omeka-s.zip

Then unzip the application:

unzip omeka-s.zip

Now we need to move everything in the omeka-s folder up one level in the test directory.

mv omeka-s/*

This following command moves all the hidden files in the omeka-s folder up one level as well.

mv omeka-s/.* .

The next commands removes the omeka-s directory, which should now be empty.

rm -rf omeka-s*

Finally, we will need to edit the database.ini file and add the database info we creating using the MySQL Database Wizard.
Use the following command to edit the file:

nano config/database.ini

Now you will add the database details to the file, it should look something like this:

user     = "testacct_admin"
password = "yrp@ssw0rd"
dbname   = "testacct_omekas"
host     = "localhost"
;port     =
;unix_socket =

Click ctrl + x to save the database.ini file, and you should be all set. Now you jsut need to navigate to the URL you were installing Omeka-S, such as http://test.mydomain.com, and you should see the following screen asking for you to create the first user and password:

Installing Omeka-S Alpha on Reclaim Hosting via Command Line
__________________________

For server admins only:
If you are managing the server and installing Omeka-S for a client, use the su command to assume the role of that user so there is no need to change permissions afterwards. For example, if I was logged in as root user, and wanted to assume the role of jimgroom, I would type the following command as soon as I login:

su jimgroom