SENAITE LIMS in unter 5 Minuten mit Docker ausprobieren

Am schnellsten sehen Sie sich SENAITE LIMS über das öffentliche Docker-Image an. Es enthält den Python-2.7-Interpreter, alle Systembibliotheken und eine vollständige SENAITE-Instanz. Auf Ihrem Rechner muss nichts kompiliert werden. Diese Anleitung führt Sie von einer leeren Docker-Installation zu einer SENAITE-Site im Browser.

Was Sie brauchen

• Docker Desktop (macOS, Windows) oder Docker Engine (Linux). Das Image wird für linux/amd64 und linux/arm64 veröffentlicht und läuft deshalb auch auf Apple Silicon nativ.
• Einen freien Port auf localhost. Die Beispiele verwenden 8080.
• Etwa 500 MB Download.

Das richtige Tag wählen

Das Image heißt senaite/senaite und liegt auf Docker Hub. Zwei Arten von Tags sind wichtig:

Ein Tag latest gibt es nicht. Die README des senaite.docker-Repositorys zeigt noch senaite/senaite:latest, und dieser Befehl scheitert mit einem Manifest-Fehler. Nehmen Sie 2.x, um zu sehen, was SENAITE heute kann, und ein Versions-Tag, wenn eine Demo nächsten Monat noch genauso aussehen soll.

Den Container starten

docker run --rm --name senaite -p 8080:8080 senaite/senaite:2.x

• --rm entfernt den Container beim Stoppen und mit ihm die Datenbank darin.
• -p 8080:8080 leitet den Port des Containers auf Ihren Rechner. Ist 8080 belegt, nehmen Sie -p 8081:8080 und öffnen Port 8081.

Sobald im Log eine Zeile mit Ready to handle requests endet, läuft die Instanz.

Eine SENAITE-Site anlegen

Öffnen Sie http://localhost:8080 und klicken Sie auf Create a new SENAITE site. Melden Sie sich mit dem Benutzer admin und dem Passwort admin an. Das Formular fragt drei Dinge ab:

• Path identifier: die Id der Site in der Datenbank und der erste Teil ihrer URL. Nehmen Sie senaite.
• Title: erscheint im Browser-Tab.
• Default timezone: die Zeitzone des Labors. Sie steckt in jedem Datum, das das System speichert.

Klicken Sie auf Create SENAITE Site. Nach kurzer Wartezeit sind Sie in einem leeren SENAITE unter http://localhost:8080/senaite.

Die Daten behalten

Solange --rm im Befehl steht, ist die Site nach jedem Stopp weg. Sobald Sie etwas eingeben, das Sie wiedersehen möchten, binden Sie ein Verzeichnis für /data ein. Dort legt das Image Datenbank, Anhänge und Logs ab:

docker run -d --name senaite -p 8080:8080 \
  -v "$PWD/senaite-data:/data" senaite/senaite:2.x

Der Container kann die Site auch beim ersten Start selbst anlegen und ein anderes Admin-Passwort setzen:

docker run -d --name senaite -p 8080:8080 \
  -v "$PWD/senaite-data:/data" \
  -e SITE=senaite -e PASSWORD=bitte-waehlen \
  senaite/senaite:2.x

Mit SITE oder PASSWORD führt der Container vor dem Start der Instanz ein Buildout aus. Der erste Start dauert deshalb merklich länger und braucht Internetzugang. Die erzeugte Konfiguration liegt im Container, nicht unter /data. Ändern Sie diese Variablen später, wirkt das erst, wenn Sie den Container neu erstellen.

Was Sie sehen und was nicht

Die neue Site ist leer: keine Kunden, keine Probentypen, keine Analyseleistungen. Ohne diese Einrichtung wirkt SENAITE dünn, und deshalb fällt der erste Eindruck oft schwächer aus, als das System ist. Zwei Wege, sie zu füllen:

1. Den Testdatensatz laden, der mit SENAITE ausgeliefert wird. Er legt in einem Schritt Kunden, Probentypen, Methoden, Geräte und Analyseleistungen an. Siehe SENAITE LIMS mit Demodaten ausstatten.
2. Eine Handvoll Datensätze selbst anlegen: einen Kunden, einen Probentyp, zwei Analyseleistungen. Dann eine Probe registrieren, eingangsbuchen, Ergebnisse erfassen, verifizieren und den Bericht veröffentlichen. Diese eine Probe zeigt Ihnen mehr vom Ablauf als eine Stunde Klicken durch die Menüs.

Wo dieser Aufbau endet

Die README des Images rät selbst davon ab, diese Container unverändert produktiv zu betreiben, und zwar aus gutem Grund:

• Das Admin-Passwort ist admin, solange Sie kein anderes setzen.
• Vor der Instanz gibt es weder TLS noch einen Reverse Proxy.
• Ein einziger Prozess bedient alle Anfragen. Ein Bericht, der dreißig Sekunden rendert, belegt dreißig Sekunden lang einen seiner Threads.
• Backups, das Packen der Datenbank und Monitoring bleiben Ihnen überlassen.

Für einen Server folgen Sie der Installationsanleitung für Ubuntu 24.04 oder sehen sich die SENAITE Enterprise VM an, die den Produktionsaufbau enthält, den wir selbst betreiben.

Nach den fünf Minuten

Passt SENAITE zu Ihnen, ist der nächste Schritt meist unser 3-Tage-Workshop. Wir richten vorab ein System für Ihr Labor ein und arbeiten es in den drei Tagen mit Ihrem Team durch, mit Ihren Probentypen, Ihren Analysen und Ihrem Ablauf statt mit Testdaten.

Fragen beim Ausprobieren? Sprechen Sie uns an.