Starting with Serenji 2.6, released in July 2016, it is possible to run Serenji on Wine which is available for Linux and OS X.

1. You will need Wine 1.8 or later. As at July 2016 the version of Wine packaged with most Linux distributions is too old. Instead, use the instructions at or or as appropriate. To install Wine on OS X the instructions are at

2. Your Wine installation will require wine-mono and wine-gecko. A simple way to achieve this is to run the following command at a shell prompt (shown as $ below):
$ wine notepad.exe
If this detects that mono or gecko are not installed it will add them automatically. This is also a good test that Wine has been installed correctly and is working properly.

3. Next, install Serenji. Download the installer from and then run it using Wine, e.g.
$ wine ~/Downloads/s26.exe
This installs Serenji and concludes by launching the README file in Wine's notepad application.

4. Normal operation of Serenji requires a component called Serenji Sentry to be running on your desktop. Using your desktop application launcher, search for Serenji Sentry (SerenjiSentry.exe) and run it using Wine. This will place a Serenji Sentry icon (blue GJ logo) on your taskbar. Right-click on the Serenji Sentry icon and select 'New Serenji Task' from the pop-up menu. This will start Serenji and present you with the Task Guide.

5. The Caché or GT.M environments you want to use Serenji in will need the Serenji server-side components present. For a GT.M instance on your local Linux workstation, follow the instructions in the next paragraph. For all other cases, use the Task Guide option titled 'Loading the Server-side Components'.

If you have a local copy of GT.M for Linux installed in its default configuration, and you installed Serenji in its default configuration then the following commands will be sufficient to install the server-side components for your GT.M instance:
$ cp ~/.wine/drive_c/Program\ Files\ \(x86\)/George\ James\ Software/Serenji/GT.M/* ~/.fis-gtm/r/.
$ dos2unix ~/.fis-gtm/r/_Serenj*.m
6. To get started with Serenji, launch a terminal session and log in to your Caché or GT.M instance. Then run the Serenji Shell by issuing the following command:
> do SHELL^%Serenji()
This will establish a connection from your Caché or GT.M process to the Serenji Sentry in your taskbar, which will in turn establish a connection with Serenji.

7. Start debugging, for example by using the db command at the Serenji Shell prompt to run a routine:
s> db ^someRoutine
Serenji will display the source code for the routine and stop execution at the very first command. You can now use F8 or the toolbar buttons to step though your code.

For more information about using Serenji, use the Help menu.
Technical Notes