The Koha manual is your friend :-)

The Koha User Manual is an amazingly in-depth document that keeps getting better with each iteration, thanks to Koha Library System Project’s indefatigable Documentation Manager Nicole C. Engard. This post exemplifies a situation where it can come in handy.

Yesterday a librarian colleague reached out with a query. He is on Koha 3.20.x series and since the last 3 – 4 days, he had been noticing that the “due date” for items his staff was issuing out was coming out rather odd! For instance all the due dates were set to “18th June 2016“. He clarified that he did not have a hard due date set, so what is going on???

This morning he sent over a screen shot of the checkout operation. And boy! the date now read 25th-June-2016. This was an immediate clue! On checking out his calendar – 18th and 25th turned out to be the only two days that are marked as “library is open” in June 2016 (for issues made in these last two weeks i.e.  before the holidays begin) during their summer recess.

That holiday setting working together with the system preference “useDaysMode” set to “the calendar to push the due date to the next open day” for circulations was the reason why Koha was pushing the due date beyond the usual designated due dates for each patron category.  Basically, it was just Koha doing its job (as it was asked to do) and doing it well.

If you are on 3.20, remember to read up, the relevant system preference are all explained very nicely there by Nicole C. Engard, Koha’s indefatigable Documentation Manager.

Sending email alerts via GMAIL : a marriage of convenience or is it???

Library professionals using Koha ILS quite naturally want to send email alerts of circulation details, due date reminders, overdue notices etc to the patrons / users / customers of their libraries. Google’s GMAIL free email service seems to provide an alluring option:

  • gmail is *huge*! Everyone and their uncle is on gmail – resulting in almost instantaneous delivery of emails.
  • anti-virus, anti-spam facilities that are almost second to none.
  • and most importantly,  it is FREE (as in the proverbial lunch, supported by ads that google places on its web mail interface).

It is ridiculously easy to set up Postfix email server to use GMAIL to relay (i.e. send out the emails to the actual recipients) the email alerts generated by Koha. Endless tutorials exist online. Sounds like a perfect match! A Free Software ILS and a free email service, what could be better!

However, Google is a business entity and they are here to make money – for their shareholders, and over the years Google has been slowly cutting down on the number of emails you can send out in a day. If you hit the daily mail quota limits, Gmail will quietly disable email sending from your account for 24 hours. Do it too often, they may (and do) suspend your email account.

“A marriage of convenience, is neither a marriage nor a convenience!”

No, it won’t hit you at first when you are testing the setup or when you have low circulation figures. However, as you roll out and keep expanding services, the number of alerts you need to generate to provide an even more improved user experience, you are likely to end up hitting those quota. I kid you not!

Koha ILS project changes version numbering

During the General IRC meeting on 9th March 2016, the developers voted [1] in a change in the version numbering scheme used in Koha. For almost 3+ years, Koha has been using the version 3.x. Every stable public release had an incrementally updated even number as “x” (i.e. 3.0, 3.2, 3.4… 3.18, 3.20, 3.22 et. al.). The internal development versions (used only by the developers) used the next odd number after the current stable release e.g. 3.21 was used when 3.20.x was the latest stable series.

All that is set to change with the new major version of Koha to be released in just a few days. We are going to align the time-based public releases to format. So, the upcoming stable release will be numbered 16.05, and the one scheduled for November 2016 will be 16.11.

References: [1]

We are switching to Let’s Encrypt as it exits public beta


Back in February this year, we had announced that we were switching on Let’s Encrypt SSL certificates on our servers and VMs on a trial basis. We are happy to share the news that with Let’s Encrypt finally getting out of beta stage, we are shifting to LE certs  for all our SSL support.

Why Let’s Encrypt?

From the LE website, some numbers:


Since our beta began in September 2015 we’ve issued more than 1.7 million certificates for more than 3.8 million websites. [..] We set out to encrypt 100% of the Web. We’re excited to be off to a strong start, and with so much support across the industry.

Why SSL is important to you?

By default, Koha’s OPAC and intranet sites use HTTP and *not* HTTPS. This means all data exchanged between your server and your visitor / patron / library staff accessing either of the sites over the Internet, goes over as plain clear text.

To give a real world analogy, this is like writing down your credit / debit card number, CVV / CVV2, expiry date on a postcard and posting it. Anyone that comes across the postcard while it goes from the sender to the recipient can read it. You are essentially broadcasting your user credentials to everyone on the Internet.

On the contrary, HTTPS encrypts all the data exchanged between the parties communicating. Only parties who can read the information thus encrypted is you and your user / visitor and no one else.

How does shifting to LE certs help our users?

Earlier we had to charge our users extra (INR 1200 to 2500 per year) for SSL support for their hosted OPAC and Koha ILS staff client. We were using SSL services of providers like PositiveSSL etc. However, LE’s objective is to bring affordable encryption to 100% of the world wide web – their certificate is FREE! So as our client-partner YOU get to enjoy (a) better value proposition (b) a well-supported quality SSL certificate with global recognition.

You may wonder why and how LE does this. This is what LE has to say about itself on it web site:

Let’s Encrypt is a free, automated, and open certificate authority brought to you by the Internet Security Research Group (ISRG). [..] ISRG’s mission is to reduce financial, technological, and education barriers to secure communication over the Internet.

The sponsors who have committed their support to make LE a success read like a who’s who of the modern Internet as we know it. It is also supported by American Library Association (ALA). So if you are a librarian, this endorsement will mean just how seriously LE is being taken! 😀

Even if you not a client-partner, but happen to follow this blog, we suggest that you seriously consider giving Let’s Encrypt a shot, if for nothing else for peace of mind.

Happy SSLing! 

Adding chat support to Koha

Yesterday being a lazy Sunday, I decided to tick off one of my pending TODO items i.e. watch the “Wishlist” discussion from National Koha Conclave organised by Informatics last February.

Around 34:30min into recording, Chris Cormack takes up the wishlist from ISI Kolkata. Around 35:19, Chris picks up the topic of chat facility that was on ISI Kolkata’s “wishlist”. He says that while it is unlikely that Koha itself would get one, it was really easy to integrate something like “MIBEW” and that all that is needed is someone to write up a HOWTO for that.

So, without further adieu, I decided setup a chat server on a dedicated sub-domain of The idea being we should be able to use the chat facility across any servers and user accounts we managed on our servers spread out across the globe.

Installation proved to be a cakewalk on our Debian 8.x test server. We already had LAMP and mibew specific PHP extensions in place. Next up we installed nodejs, npm and gulp and finally we cloned the mibew git repo on Github. The deployment tarball was built following the instructions on the Github page.

Once ready, we unzipped the newly created mibew-2.1.0.tar.gz tarball into the DocumentRoot of the sub-domain we had created earlier. The instructions given in the README.txt proved to be adequate. First, we created the MySQL database, with required user and permissions. Setting the ‘cache‘ folder to writable by the webserver process was important. Next up, the database connection configuration went up into configs/config.yml which was templated off configs/default_config.yml.

Final setup was done by accessing http://<our-sub-domain_FQDN>/install.php and following the on-screen wizard. The admin user and password were setup and we were basically done. For the sake of security, the install.php was removed from the tree.

Logging in as the admin user, we setup a new group and added a new user to that group to work as an operator representing our client. The chat button code was copied over and pasted into the OpacNavRight system preference in Koha and saved all the changes made.

On the Mibew server side, things were just as simple. We logged in as user “brclibrarian” that we had created for Bhaktivedanta Research Centre. To make the user “brclibrarian” available for chat, we clicked on “Connect”.

Upon going “online” as brclibrarian user, the dashboard changed into an “inbox” page, where we now waited for our first support request.

Soon enough, a visitor on BRC OPAC had clicked on the chat button and we had our first support chat coming live at the “operator” side of things.

On the visitor’s side, the following screenshot shows the support chat in progress.

P.S. We wanted our chat button to say “Ask a Librarian“. So instead of using the default buttons that come with MIBEW, we used GIMP to quickly make a couple of images and saved them as aal_on.gif and aal_off.gif. The  “_on” and “_off” in the filenames is important. MIBEW reads the image name as “aal” with on and off markers treated as toggle.

To display when librarian / operator is absent.

To display when librarian / operator is online.

Sivanath Sastri College Library partners with L2C2 Technologies to take their library online

We are pleased to announce that Sivanath Sastri College, Kolkata, also known popularly as “South City Morning” has chosen to partner with L2C2 Technologies for taking their library online. Our thanks goes to the college authorities and the library Smt. Bhaswati Chattopadhyay for making this possible. The OPAC is live at

About the Sivanath Sastri College

Sivanath Sastri College is a 55 year old undergraduate liberal arts college for women in South Kolkata (Calcutta). It is affiliated with the University of Calcutta. The name commemorates the legacy of Brahmo social reformer Sivanath Sastri.