How to Install RERO ILS on Windows 11

RERO ILS is a powerful open-source Integrated Library System that manages library operations such as acquiring, cataloging, circulating, and providing access to library resources. In this tutorial, we will guide you through the steps to install RERO ILS on your Windows 11 computer.

Prerequisites

  • Windows 11 computer with at least 4 GB of RAM
  • Python 3.6, 3.7, 3.8, or 3.9 installed
  • PostgreSQL 11 or higher installed
  • Git installed

Step 1: Clone the RERO ILS Repository

  1. Open the command prompt by typing cmd in the Windows search bar and select "Run as administrator".
  2. Navigate to the directory where you want to store the RERO ILS source code.
  3. Run the following command to clone the RERO ILS repository:
git clone https://github.com/rero/rero-ils

Step 2: Install Required Python Packages

  1. Navigate to the rero-ils directory in the command prompt by running:
cd rero-ils
  1. Run the following command to install the required Python packages:
python -m pip install -r requirements.txt

Step 3: Configure the RERO ILS Settings

  1. Create a copy of the server.cfg.example file in the instance directory and name it server.cfg.
cp instance/server.cfg.example instance/server.cfg
  1. Open the server.cfg file in a text editor and configure the following settings according to your environment:
SQLALCHEMY_DATABASE_URI=<your database URI>
SECRET_KEY=<your secret key>

Note: Replace <your database URI> and <your secret key> with your actual database URI and secret key.

Step 4: Create the Database Schema

  1. Open the command prompt and navigate to the rero-ils directory.
  2. Run the following command to create the RERO ILS database schema:
python manage.py create_db
  1. Run the following command to load the initial data:
python manage.py load_data

Step 5: Run the RERO ILS Server

  1. Open the command prompt and navigate to the rero-ils directory.
  2. Run the following command to start the RERO ILS server:
python manage.py runserver
  1. Open a web browser and enter the following URL to access RERO ILS:
http://localhost:5000/

Congratulations! You have successfully installed RERO ILS on your Windows 11 computer. You can now configure your library branches, add users, and manage library resources using RERO ILS.