Fixing problems with IBM Notes on macOS Mojave

Sunday, October 7, 2018 at 1:59 PM UTC

I am using Mojave for some months now. I never used the Notes client on macOS but since there is a special interim fix for Mojave I thought I give it a try. The installation process is usually simple:

  • install the client package
  • install the fix right afterwards (without trying to start the client for the first time)

Please also read this blog post from Gab Davis on which installer to use.

Notes on a Mac is completely different from what we are used in Windows. The Notes data folder is located in

/Users/<accountname>/Library/Application Support/IBM Notes Data/

and the „notes.ini“ is a file called „Notes Preferences“ located in


The contents of this file however is the same as in any other notes.ini file. This saved my ass.

For some reason I wasn’t able to install the client on my Macbook Pro as there were files left from a previous installation - I can’t recall to have Notes installed, but hey, I use this system for more than one year without wiping it.

So the first task was wiping the old installation which can be a hassle if you do not have the uninstaller. There is a manual way to do so described in an IBM technote:

My second attempt ended up in these messages when trying to start Notes for the „first time“:

There was a second error message that named the path to the local Notes data folder, too.

I checked the path and - obviously - no names.nsf there. Of course not, I wiped previous installs with AppCleaner. One thing the „uninstall“ process I made forgot to remove the notes.ini (aka Notes Preferences).

To fix this just find the file, open it with a text editor and remove everything from it except the first 4 lines (containing the install type/kit features) - just as you are used to do in Windows versions. This will bring up the general configuration dialogs that allow you to setup your ID, server, etc.

Problem 1 solved.

Another problem was that the whole operating system gets freezed when starting Notes. This is because of the security setting that allows Notes control the accessibility features. Just disable Notes in that list:

Problem 2 solved.

Now you should be able to start Notes without any problems. Thanks to Manfred Dillmann for the hint!

Another caveat in Mojave

I experienced a serious problem (aka crash) switching to the „Operating System Theme“ in the Notes „Windows and Theme“ preferences. DO NOT SWITCH to this theme on Mojave! I am not sure if this is because of the dark mode I use since I also had crashes right about the start with the light mode, too. At least I was able to switch back to the „Social Theme“ when activating the light mode. After I switched the theme I also switched back to dark mode - and it works again.

Latest comments to this post

Ludovico Susani wrote on 10.04.2019, 17:18

I am experiencing the very same problem described by Frederik after the update to MacOS 10.14.4. Any solution?


 Reply to this comment
 Link to this comment
Frederik Riebbels wrote on 31.03.2019, 09:14

Since macos mojave 10.14.4 update ibm notes 9.0.1 if16 crashes wheb changing preferences. Any one has this to? Any clue?



 Reply to this comment
 Link to this comment
Jan Igaard wrote on 20.03.2019, 11:01

Can someone please send me the fix, as I can't download it...? ( jan.igaard ( at ) )

 Reply to this comment
 Link to this comment
Fabiano wrote on 22.01.2019, 19:18

Please, anyone could send hotfix (if16) for me? I can`t download it.



 Reply to this comment
 Link to this comment
Angelo wrote on 09.01.2019, 17:49

Thanks,  the advice to disable accessibility saved my life from a bunch of angry users.

 Reply to this comment
 Link to this comment
Randy Giffen wrote on 25.11.2018, 16:30

Thanks, turning off accessibility helped speed up startup and prevents os freezing

 Reply to this comment
 Link to this comment
Andrew Magerman wrote on 22.11.2018, 16:19

Thanks for the tip, Oliver. Mojave was driving me mad with those freezes.

 Reply to this comment
 Link to this comment
Koen wrote on 08.11.2018, 10:43

hello Oliver,

Thanks a lot for this post. Lotus Notes X was driving me insane with the freezing (described as problem 2 in your article)  during start up (and random freezing during the day).

What I did not notice is that Lotus Notes X is eating away huge amounts on internal memory so I need to keep an eye on that in the future.


 Reply to this comment
 Link to this comment
Ernst Mayer wrote on 09.10.2018, 08:49

Hi there,

it's always good to hear, that other persons have similar problems using notes on Mac. :)

In my case I use a Macbook Pro (late 2012) and notes running without any special problems (until high sierra). After installing Mojave and starting notes  it hangs. And after installing IF16 (SHF993) (without any problems) notes runs without hanging after startup.

I didn't have to change any further settings. So maybe there are other constellations that makes your macbook instable. 

Best wishes

 Reply to this comment
 Link to this comment

Leave a comment right here