Need help with omeka-s?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

omeka
268 Stars 87 Forks GNU General Public License v3.0 6.0K Commits 156 Opened issues

Description

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.

Services available

!
?

Need anything else?

Contributors list

Omeka S

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

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:

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.