README

Omeka S is a web publication system for universities, galleries, libraries, archives, and museums. It consists of a local network of independently curated exhibits sharing a collaboratively built pool of items, media, and their metadata.

See the user manual for more information.

Installation

Requirements

• Linux
• Apache (with AllowOverride set to "All" and mod_rewrite enabled)
• MySQL 5.7.9+ (or MariaDB 10.2.6+)
• PHP 7.4+ (latest stable version preferred, with PDO, pdo_mysql, and xml extensions installed)

Generating thumbnails

• The default library for generating thumbnails is ImageMagick, at least version 6.7.5. Older versions will not correctly produce thumbnails. For alternative thumbnail options, see the user manual.

Installing from GitHub

1. Make sure Node.js and npm are installed
2. Clone this repository in your Apache web directory:
   • $ git clone https://github.com/omeka/omeka-s.git
3. Change into the Omeka S directory:
   • $ cd omeka-s
4. Perform first-time setup:
   • $ npm install
   • $ npx gulp init
5. Open config/database.ini and add your MySQL username, password, database name, and host name. The user and database must be created before this step.
6. Make sure the files/ directory is writable by Apache.
7. In your web browser, navigate to the omeka-s directory, where you can complete installation.

Installing from released zip file

1. Download the latest release from the release page (download the first asset listed)
2. Open config/database.ini and add your MySQL username, password, database name, and host name. The user and database must be created before this step.
3. Make sure the files/ directory is writable by Apache.
4. In your web browser, navigate to the omeka-s directory, where you can complete installation.

You can find Omeka-specific code under application/.

Updating

Make a backup copy of your entire site and its database!

Updating from GitHub

1. git pull as usual. Use the master branch for the latest releases.
2. From the Omeka S root directory, run npx gulp deps to make sure dependencies are up to date.
3. Compare changes in /config/local.config.php and /config/local.config.php.dist. Some default configurations might have changed, so you might need to reconcile changes to the distributed configuration with your local configuration (e.g., a path to PHP specific to your server, dev mode settings, etc.)
4. In your web browser, go to your site and run any migrations that are needed.

Updating from released zip file

1. Download the latest release from the release page
2. Make a copy of your /config directory. You will need to restore your local.config.php and database.ini files from that copy.
3. Make a copy of your /modules and /themes directories.
4. Make a copy of your /files directory.
5. Remove all Omeka S files, and replace them with the files from the updated zip file.
6. Replace your original /config/local.config.php file, and the /modules, /themes, and /files directories that you copied.
7. In your web browser, go to your site and run any migrations that are needed.

Creating a zipped release

Run npx gulp zip to create a zipped version of Omeka S and store it in /build. Use the --no-dev flag to omit Composer dev dependencies for a smaller package suitable for end-users. Official releases follow this same process from a new, clean checkout.

Libraries

Omeka uses the following libraries, among others:

• Laminas
• Doctrine 2
• EasyRdf
• PHPUnit
• jQuery

Development Standards

Omeka development adheres to the Laminas Coding Style Guide and uses the git-flow branching model and the Semantic Versioning 2.0.0 version scheme.

See the developer documentation for more information.

Copyright

Omeka is Copyright © 2015-present Corporation for Digital Scholarship, Vienna, Virginia, USA http://digitalscholar.org

The Corporation for Digital Scholarship distributes the Omeka source code under the GNU General Public License, version 3 (GPLv3). The full text of this license is given in the license file.

The Omeka name is a registered trademark of the Corporation for Digital Scholarship.

Third-party copyright in this distribution is noted where applicable.

All rights not expressly granted are reserved.