OpenLibry ist die freie, quelloffene Web-App, die Ihre Schulbücherei unterstützt. Kostenlos, einfach zu bedienen und lokal installierbar.

Wir sind von Biblioweb zu OpenLibry migriert und zeigen in diesem Beitrag wie das geht und was zu tun ist, um ObenLibry zu installieren.

Voraussetzungen und Installation:

Wir haben in der Schule einen Docker-Host, auf dem verschiedene Docker-Container laufen, jetzt eben auch OpenLibry. OpenLibry kann aber auch ohne Docker z.b auf einem Raspberry Pi 4 installiert werden.

https://openlibry.de/site/getting-started/requirements/#raspberry-pi

Die Installation ist gut dokumentiert und zeigt eine Schritt für Schritt Anleitung – inklusive Docker-Installation.
https://openlibry.de/site/installation/container/#schritt-1-docker-installieren

Wir verwenden docker compose und so sieht unsere docker-compose-Datei aus.

services:
openlibry:
image: jzakotnik/openlibry:latest
ports:
- "3000:3000"
volumes:
# Persist SQLite database on the host
- ./database:/app/database
- ./images:/app/images
environment:
- NODE_ENV=production
- DATABASE_URL=file:/app/database/dev.db
- COVERIMAGE_FILESTORAGE_PATH=/app/images
- NEXTAUTH_SECRET=${NEXTAUTH_SECRET}
env_file:
- .env
restart: unless-stopped

Im Ordner, in dem sich auch das docker-compose-File befindet gibt es zwei Ordner. database und images

Zusätzlich braucht es noch eine „.env“-Datei, in der einige Einstellungen gespeichert und von Docker an openlibry weitergegeben werden. Am besten kopiert man sich die Beispieldatei aus dem Github-Rep.
https://github.com/jzakotnik/openlibry/blob/main/.env_example und geht Zeile für Zeile durch und pflegt die gewünschten Änderungen ein (AUTH_ENABLED sollte noch auf false bleiben). Anschließend kann der Container gestartet werden. Mit docker compose lautet der Befehl

docker compose up -d

Falls das Docker-Image noch nicht heruntergeladen wurde, wird das dadurch gemacht und nachher der Container gestartet.

OpenLibry läuft jetzt unter http://<domain>:3000 und startet automatisch nach einem Neustart.

Ersten Benutzer anlegen

  1. Öffne http://<domain>:3000/auth/register
  2. Erstelle einen Admin-Benutzer
  3. Bearbeite die .env und setze AUTH_ENABLED=true
  4. Container neu starten: docker compose restart

Jetzt kann man sich als Administrator einloggen.

Medien und Benutzer importieren:

Für den Import gibt es eine API, mit der Medien und Benutzer aus anderen Programmen importiert werden können. In Biblioweb gibt es unter „Tools und Optionen“ den sogenannten „Mediendatenexport im CSV-Format“. Für unsere Medien haben wir das gemacht. Anschließend haben wir das CSV-File mit folgendem PythonScript importiert.

import requests
import json

BASE_URL = "http://localhost:3000/api"

def import_book(book_data):
    """Einzelnes Buch importieren"""
    response = requests.post(
        f"{BASE_URL}/book",
        json=book_data,
        headers={"Content-Type": "application/json"}
    )
    return response 

def import_books_from_csv(csv_path):
    """Bücher aus CSV importieren"""
    import csv
    with open(csv_path, 'r', encoding='utf-8-sig') as f:
        reader = csv.DictReader(f,delimiter=',')
        for row in reader:                    
            book = {
                "id": int(row["Mediennummer"]),
                "title": row["Sachtitel"],
                "subtitle": row["Titelzusatz"],
                "author": row['Verfasser_1'],
                "isbn":  row.get("ISBN13") or row.get("ISBN"),
                "topics": row.get("Schlagworte", ""),
                ## Verlagsort is acutally the publisher in the .csv"
                "publisherName": row.get("Verlagsort"),
                "publisherLocation": row.get("Erscheinungsjahr"),
                "renewalCount": 0
            }
            result = import_book(book)
            if (result.status_code != 200):
               print(book)
            
import_books_from_csv("buecher.csv")

Die Benutzer importieren wir ebenfalls per CSV-Datei. Diese kommt aber aktuell aus der Verwaltung.

import requests
import json

BASE_URL = "http://localhost:3000/api"

def import_user(user_data):
    """Einzelnes Benutzer importieren"""
    response = requests.post(
        f"{BASE_URL}/user",
        json=user_data,
        headers={"Content-Type": "application/json"}
    )
    return response.json()        

def import_students_from_csv(csv_path):
    import csv
    with open(csv_path, 'r', encoding='utf-8-sig',errors='ignore') as f:
        reader = csv.DictReader(f,delimiter=';')
        count = 1
        for row in reader:                    
            user = {
                "id":int(row["sokratesID"]),
                "firstName": row["vorname"],
                "lastName": row["nachname"],
                "schoolGrade": row['klasse'],
                "eMail":  row.get("email")
            }       
            result = import_user(user)
            print(f"Importiert: {user['lastName']} -> ID: {result.get('id')}")
            count=count+1


import_students_from_csv("benutzer.csv")

Der API-Import ist gut dokumentiert und kann entsprechend angepasst werden.
https://openlibry.de/site/import/api-import/

Für die Schüler-ID verwenden wir die SokratesID. Dieses befindet sich auch auf den EDU-Karten als Bar-Code. Damit ist es möglich die Ausleihe per Barcode-Scanner durchzuführen.

Referenzen

Website: https://openlibry.de/

Benutzerhandbuch: https://openlibry.de/site/user-guide/

Import-API: https://openlibry.de/site/import/api-import/#nachste-schritte

Git-Repo: https://github.com/jzakotnik/openlibry

Screenshots

Kategorien: AllgemeinHowTo

1 Kommentar

Jure · 17.10.2026 um 12:05

Super, vielen Dank für die Erwähnung 🙂
Wir haben mittlerweile auch einen Discord Community Kanal – hier verlinkt: https://discord.gg/WpkNBFMRq

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert