Overview# This is a personal note on updating Omeka S. Please also refer to the following official documentation.
https://omeka.org/s/docs/user-manual/install/#updating
Preparation: Backup# Before performing update operations, be sure to create backups of the database and all files in case of unforeseen circumstances.
1. Database Backup
Create a database dump file using the mysqldump command or similar.
# m y m s y q s l q d l u d m u p m p - u - u d b [ _ D u B s e u r s e - r p n a o m m e e ] k a - _ p s _ [ d D b B > n a o m m e e ] k a > _ s [ _ o b u a t c p k u u t p . f s i q l l e n a m e ]
2. File Backup
Back up (duplicate) the entire Omeka S installation directory.
c # c # # d p W O t / h - r a h e r , r o n m o w - e c m h c / o e e z n p k n v a y a f k i - c a n s o o m g m m u o p e r t m r k a h e e a / e k s - w a s s w e - i _ w n s n b t _ g a i b c r a a k e c n u k d p d u _ i p s 2 r _ a 0 e 2 v 2 c 0 i 4 t 2 n 0 o 4 g 8 r 0 0 y 8 w 1 0 i . ( 1 t t a h a d r d t . i a g n r z g o a m e d k a a t - e s i s c o n v e n i e n t )
Maintenance Mode# Before updating, switch to maintenance mode.
Install the following EasyAdmin module.
https://omeka.org/s/modules/EasyAdmin/
Then, access the settings page from the “Settings” button.
/admin/setting
For the “Maintenance” item, check “Public front-end” for example and save.
As a result, the maintenance page will be displayed.
Updating the Core and Default Theme# Navigate to the directory where Omeka S is installed and execute the following.
c d / h o m e / n a k a m u r a / w w w / o m e k a - s
Below is an example of updating to v4.1.1.
v w u r r r m m m m m m r m r e g n m m m v v v v v v m v m r e z s t i - - - o o o o o o - o - i p r r r m m m m m m r m r o h f f f e e e e e e f e f n t o k k k k k k k = t m a v a a a a a a a o 4 p e . p e - - - - - - / - m . s k z p n s s s s s s t s e 1 : a i l d / / / / h / k . / - p i a c L R v e t a 1 / s c r p . o I E e m h - g - a p p m C A n e e s i $ t l h p E D d s m t v i i p o N M o / e h e o c s S E r d s u r n a . e E . e / b s t r m . f d . i i . . d a e c o o * u f o n n . l a m . t u z . l o i t m p e k / a t / h o e m m e e k s a / - s / r e l e a s e s / d o w n l o a d / v $ v e r s i o n / o m e k a - s - $ v e r s i o n . z i p When you access /admin, you will be redirected to /migrate and the following screen will be displayed. Press the “Update Database” button.
If you navigate to the admin screen and see “Migrated”, the update was successful.
Updating Modules# Update modules as well.
Modules that can be updated will be displayed as shown. Additionally, when updating from Omeka S v3 to v4, there may be cases where modules cannot be run without updating due to version incompatibilities.
First, navigate to the modules directory.
c d / h o m e / n a k a m u r a / w w w / o m e k a - s / m o d u l e s
Then, create a file with the following content. Change the target modules as appropriate.
# # d # f d ! e o o / S c L r n b t l o e i o a " " " " " " " " " " " o m # r e # r # w # Z # u r n r r C B C L B F I I I R E p o e c m g I n m / e e o u l o u a i m i e a d S a h D D e G P U z b m l e g l c i a i f s t u p d o e - o t e _ n i " a m - m k a k e f g f e y h l l l r w t F z p $ s o a o E n h I t S e V r A r e i - " e f n " I i Z h d n x U t m e e S i e d o t r P t l $ t L p " I u m p r t p d r e e n m u i r e " o M h E $ P l o h o l p o B v r w c i g n m M o $ a O e = t Z _ e d t r s r r e v e e n h o O c e M d D $ h I F u t t h : t o r e r " d D e x O U z ( e P I n l p t / w r s h h e $ u U s i D t L i b _ L a e s h t / h s h t t a { l L s s U h E p a f F E m s : t p g t e t h h t t c m e E i t L e _ s i I " e = / t s i t t t t p p h o _ n i E U f e l L ( / p : t p h p t t s s d n N g n _ m R i n e E a g s / h s t s p p : : e u a A g N o L l a " n i : u : t : s s / l l m M $ A d " e m a d t g b p / : : / e e e E M m M u e n h / i . / s / / g g m s O o E l n d U u g t c g : g / i i e [ a M D d " e a " R b i h o i / i g g t t n @ n O U u m $ t L . t u m t / t i i h h t ] d D L l z e M h c h b h g h t t u u } U E e i O e p o u . D u i u h h b b o " U L _ p D n a m b c a b t b u u . . f ; R E N d U i / . o n . h . b b c c L _ A i f L d r D c m i c u c . . o o t d U M r i E e s a o / e o b o c c m m h o R E e l _ l n m D l m . m o / / e L c e U e i i / a - c m m D D f t R t n e D n K D D / / a a a r o L e l a i M a m a D n n n r o r " a - n e / n / n a a i i r m y ) t n K i l O i o i n k e e a h M e - m e m e i a l l y " $ e a / l K e l e l e m - - $ M r O - M k - k - l u K K m O z r m K / a K a K - r M M o D i a e M O - M - M K a / / d U p y k / m S / s / M 1 O O u L a O e - O - O / 9 m m l E - m k m m m m O 6 e e e _ S e a o e o e m / k k " U - k - d k d k e O a a R m a S u a u a k m - - L o - - l - l - a e S S " d S m e S e S - k - - u - o - - s - S a m m l m d L m m - - o o e o u o F o m S d d - d l g d a d o - u u C u e / u c u d m l l o l - r l e l u o e e m e C e e t e l d - - m - l l - e - e u R E o B e e B d I - l e a n u a a u B i I e f s / l n s l r i m - e y r k U e k o f a I r A e E r s I w S g i e d l x l m s e e i n m e p d p e r S f c i a r o o / v e V e n s r e w r r e r i / / e t l n t e r e r r s e l l / e w e e r a r e r r e l l d e s a e a e / r e e o l e d l s l r s a a w e s e e e e / s s n a 3 a s a l r e e l s d . s / s e e s s o e o 4 e d e a l / / a s w . s s s e d d d n 2 w / e a o o d l 4 d n d s s w w 3 o o / o l o / e n n . w a L w o w d s l l 4 n d n a n o / o o . l g l d l w d a a 6 3 - o / o n o d d 1 a . 3 a v a l w / / / d 1 . d 1 d n 3 3 C 7 4 . a l . . 3 . . 3 5 3 d 4 4 m . 7 2 . . . a . . m 4 4 4 1 6 3 d 4 2 o . C . . / . . / 9 0 n 3 l z 5 F 2 6 1 / - 4 e i 6 a 1 . . R E 3 a p / c 1 2 e a . B n " B e I 8 . f s 4 u U u t i 5 e y . l r l e i I / r A 6 k l k d f m I e d 1 E - I B S a i n m . x 3 m r e g i c i z p . p o r e f e n i o 1 o w v S V - - p r 7 r s e e i 3 3 " t . t e r r e . . - 7 - - - v w 4 4 3 . 3 1 3 e e . . . z . . . r r 4 2 4 i 4 5 6 - s 9 0 . p . . . 3 - . . 3 " 5 1 2 . 1 z z 4 6 . 1 6 . i i . . z . . 2 p p z z i z 1 . " " i i p i 8 5 p p " p . . " " " z z i i p p " " Then, execute the following.
b a s h u p g r a d e . s h
As a result, an “Upgrade” button will be displayed for updated modules, so press the button. Note that recent modules often require the “Common” module to be installed beforehand, so it is recommended to install it first.
Summary# Finally, disable maintenance mode to complete the update process.
Since errors may occur during the update process, it may be helpful to change the settings in the .htaccess file as follows. Also, don’t forget to switch back to production mode after completing the update.
# S e S t e E t n E v n v A P A P P L P I L C I A C T A I T O I N O _ N E _ N E V N V " d " e p v r e o l d o u p c m t e i n o t n " "
I hope this serves as a useful reference for operating Omeka S.
Update History# 2026/02/06: Added backup procedure 2024/08/01: Article published