Upgrading Omeka



From http://omeka.org/codex/Upgrading 

  1. Always back up your database in case something goes wrong during the upgrade. For instructions, see Backing up an Omeka Database.
  2. Deactivate your plugins in Settings > Plugins of the administrative panel.
    • Be careful not to uninstall the plugins, because you may lose data. See Upgrading Plugins for more information.
    • Check to make sure your plugins are compatible with the version of Omeka you're upgrading to. Especially when moving from 1.x to 2.x, you may need to use updated versions of plugins instead of the old ones.
  3. Move your old Omeka installation out of the way, either to somewhere else on your server or transfer the files to your local computer.
  4. Download and unzip the latest version of Omeka into the empty directory where your previous install of Omeka was located.
  5. Move or copy the following files and directories from your old Omeka folder to the corresponding location in your new Omeka installation (if copying, make sure you keep all permissions the same as they were before):
    • db.ini (in version 0.9, this was located in application/config/db.ini; since version 0.10 this has been relocated to the root of your installation.)
    • files/ (for versions below 2.0, the folder is instead named archive/)
      • If you are upgrading from 1.x to 2.x rename archive to files, and rename the files/files in the directory you just renamed to files/original
    • Any themes or plugins you had installed. The bundled themes and plugins (currently Coins, Exhibit Builder, and Simple Pages) will already have been updated with Omeka, so you don't have to move them back over.
    • If you've modified any of Omeka's core files, you'll need to move those changes over too (be careful with this, as the original file may have been changed in newer versions).
  6. Finally, you may need to upgrade your database. Go to your site's administrative panel in your web browser.
    • If a database upgrade is needed, you'll automatically be redirected to an upgrade page (example.com/admin/upgrade). Click "Upgrade" to update your database to reflect the new data model and finish the upgrade. Omeka 1.2.1 and earlier only: Instead of redirecting, older Omeka versions will show an alert on your dashboard with a link to follow if the database needs to be upgraded.
    • If you weren't redirected when you went to your administrative panel, then no database changes were required, so you're done!






may have permissions issues re: file upload delete - 

Make Omeka's storage directory and its sub-directories writable by the web server. For Omeka 1.5.3, the directory is 'archive'. For Omeka 2.0+, the directory is 'files'. You can change the permissions yourself with an FTP or other file transfer program, or with shell commands over SSH. If you're not sure what to do, ask your host for advice, or to change the permissions for you.

rename current “files” directory to something like “files-old”  and then create new one in same space with name “files”  - if not working check that it is writeable by the web server



to avoid WYSIWYG stripping out code issues - after upgrading go to Settings >Security  and DESELECT the checkbox under “Enable HTML Filtering”


Pasted Graphic.tiff






Upgrading Plugins

These are some general instructions for upgrading plugins. If a plugin you're upgrading contains specific upgrading instructions, follow those.

  1. Always backup of your database in case something goes wrong during the upgrade (highly unlikely, but just to be safe). For instructions, see Backing up an Omeka Database.
  2. Deactivate the specific plugin you're upgrading in Settings > Plugins of the administrative panel.
  3. Download and unzip your copy of the latest version of the plugin.
  4. Copy the new plugin files and directories into your plugins directory
  5. Reactivate the plugin in Settings > Plugins in the admin panel.