Skip to content


Repository files navigation

Github actions status image Release Number License Gitter room Translation status Poetry



The elegant solution for heritage, public and school libraries or networks.
Live Demo » · User docs » · Developer docs »

Website · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Usage
  3. Getting started
  4. Contributing
  5. License
  6. Contact

About the project


RERO ILS is a new generation open source integrated library system developed in Switzerland by RERO+ in collaboration with the Catholic University of Louvain (UCLouvain). It allows the management of library networks or independent libraries (document acquisition, circulation, cataloguing, search) and offers a public interface for users.

RERO ILS has been under heavy development since 2017 as a replacement for RERO network's legacy software. Its first major release (v1.0.0) was published at the end of 2020. The first real-life production instance has been live since June 2021. Since then, it is being actively maintained and developed by a committed team from Switzerland and Belgium, in order to improve upon its current features and satisfy its users' needs.

Built with

(back to top)



To explore the system, you can try the test instance or take a look at one of the production instances: RERO+ network (live since Summer 2021) and UCLouvain network (live since early 2022).


  • 🌐 Consortial model: built primarily for library networks, large or small, with several levels of configuration included (organization, library).
  • 📚 Cataloguing and serial management: modern cataloguing editor in compliance with current standards (RDA, BibFrame); in-depth management of periodicals, subscriptions, and issue predictions.
  • 💻 Online catalog: public online catalog with simple but powerful search and filtering functions; customizable views by organization and library; seamless integration of resources from external platforms (ebooks, databases, etc.).
  • 📖 Circulation module: perform all the operations required by libraries: check-out, check-in, item requests, interlibrary loans, patron management, in a modern, fast and ergonomic web interface.
  • 🔃 Data interaction and openness: JSON formatted bibliographic data Bibframe model with a powerful API to interact with the database.


RERO ILS is open source and can be can be deployed and hosted by anyone, provided they can afford the required configuration or development effort. It can also be hosted as a service by RERO+ for any interested library or organisation.

The user documentation for RERO ILS is hosted on flask-wiki.

(back to top)

Getting started


The ecosystem

Three GitHub repositories for RERO ILS

The rero-ils GitHub project contains the main project for RERO ILS, basically providing the invenio backend. To work on the frontend of the project, you also need rero-ils-ui, which is based on ng-core.


The MEF (Multilingual Entity File), provides authorities (or entities) to RERO ILS, in two languages: French and German (for now). This is used to link documents to controlled descriptions of authors and subjects. MEF can aggregate multiple authority files, such as IdRef and GND. These authority files are then aligned through VIAF, thus providing multilingual authorities.

As a result, in order to run RERO ILS, you need to either use our public MEF server, or run your own.


RERO ILS customers make use of 3rd-party ebook commercial platforms. A dedicated server has been set up for harvesting ebook metadata from those platforms, convert them to RERO ILS's own data model. RERO ILS harvests our ebooks server, importing the metadata into the union catalog, assigning each ebook to the corresponding subscribing libraries.

This server is not publicly accessible but the source code is available on GitHub: rero-ebooks.

You need to prevent your RERO ILS instance to harvest RERO's ebooks server, but you can run your own ebooks server.

(back to top)


Any contribution is greatly appreciated!

(back to top)


Distributed under the GNU Affero General Public License. See LICENSE for more information.

(back to top)


  • If you have questions, you can ask the development team on Gitter.
  • In case of a security issue, please contact the e-mail address provided in the security policy.

(back to top)