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.
- Linux
- Apache (with AllowOverride set to "All" and mod_rewrite enabled)
- MySQL 5.6.4+ (or MariaDB 10.0.5+)
- PHP 7.1+ (latest stable version preferred, with PDO, pdo_mysql, and xml extensions installed)
- The default library for generating thumbnails is ImageMagick, at least version 6.7.5. Older versions will not correctly produce thumbnails. See local.config.php options in the documentation.
- Make sure Node.js and npm are installed
- Clone this repository in your Apache web directory:
$ git clone https://github.com/omeka/omeka-s.git
- Change into the Omeka S directory:
$ cd omeka-s
- Perform first-time setup:
$ npm install
$ npm install --global gulp-cli
(if you do not already havegulp
installed)$ gulp init
- 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. - Make sure the
files/
directory is writable by Apache. - In your web browser, navigate to the omeka-s directory, where you can complete installation.
- Download the latest release from the release page
- 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. - Make sure the
files/
directory is writable by Apache. - In your web browser, navigate to the omeka-s directory, where you can complete installation.
You can find Omeka-specific code under application/
.
Make a backup copy of your entire site and its database!
git pull
as usual. Use themaster
branch for the latest releases.- From the Omeka S root directory, run
gulp deps
to make sure dependencies are up to date. - 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.) - In your web browser, go to your site and run any migrations that are needed.
- Download the latest release from the release page
- Make a copy of your
/config
directory. You will need to restore yourlocal.config.php
anddatabase.ini
files from that copy. - Make a copy of your
/modules
and/themes
directories. - Make a copy of your
/files
directory. - Remove all Omeka S files, and replace them with the files from the updated zip file.
- Replace your original
/config/local.config.php
file, and the/modules
,/themes
, and/files
directories that you copied. - In your web browser, go to your site and run any migrations that are needed.
gulp zip
will 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.
Omeka uses the following libraries, among others:
Omeka development adheres to the Zend Framework 2 Coding Standards and uses the git-flow branching model.