Hardware

KEEPIQ braucht keinen leistungsstarken Server in der Ecke.

Es folgt einem einfachen Prinzip: Rechenleistung nutzen, wenn etwas passiert — und still bleiben, wenn nichts passiert.

Artikel anlegen. Barcode scannen. Ort aktualisieren. Bestand durchsuchen. KEEPIQ antwortet und legt sich danach wieder schlafen. Es gibt keine dauerhaften serverseitigen Polling-Schleifen; in unseren Tests auf dem Raspberry Pi liegt die CPU-Last im Leerlauf bei etwa 0–2 %.

Damit ist günstige — und bereits vorhandene — Hardware ein völlig sinnvolles Zuhause für KEEPIQ.

KEEPIQ selbst ist klein.

Der Node-Server belegt im Leerlauf rund 90–140 MB RAM, mit kurzen Spitzen auf etwa 250 MB bei schwereren Vorgängen wie einem CSV-Import oder einem Foto-Upload. Eine lokale PostgreSQL-Datenbank in KEEPIQ-Größe benötigt weitere 60–120 MB. Die CPU kehrt direkt nach dem Vorgang in den Leerlauf zurück.

Spracherkennung, Barcode-Dekodierung und Fotokomprimierung laufen im Browser — auf dem Telefon oder Kiosk in Ihrer Hand, nicht auf dem Server. Der Pi erhält nur den resultierenden Text, Code oder das komprimierte Bild.

Scannen. Anlegen. Finden. Aktualisieren. Schlafen.

Empfohlene Hardware

Ein dedizierter Raspberry Pi 5 ist für eine normale KEEPIQ-Installation keine Voraussetzung. Für die meisten Haushalte, Werkstätten und kleinen Betriebe genügt ein Raspberry Pi 4 vollkommen.

Experimentell, noch nicht validiert: Ein Pi Zero 2 W (512 MB) kann eine Installation ohne Bildschirm ausführen, wir haben das aber nicht auf echter Hardware gemessen. Betrachten Sie es als erwartet funktionsfähig, nicht als empfohlen.

Ohne Bildschirm läuft KEEPIQ am sparsamsten.

Installieren Sie es auf dem Raspberry Pi und greifen Sie von den Geräten darauf zu, die Sie bereits besitzen — Telefon, Tablet, Laptop, Desktop. Der Pi betreibt den Dienst; die Oberfläche läuft in Ihrem Browser, wodurch der Server-Fußabdruck extrem klein bleibt.

Sie möchten einen festen Bildschirm?

KEEPIQ kann auch zur festen Inventarstation werden: Schließen Sie einen Touchscreen an und starten Sie den Kiosk-Modus für eine feste Oberfläche in Werkstatt, Lagerraum, Büro oder Garage.

Das Backend bleibt genauso leicht. Zusätzlich kostet nur der Chromium-Browser des Kiosks — typischerweise 350–600 MB RAM, am höchsten bei angezeigtem 3D-Grundriss. Für diese Konfiguration empfehlen wir 4 GB.

Auf einem Pi, der mit Home Assistant geteilt wird, ist der Kiosk-Modus im Installer standardmäßig aus und wird verweigert, wenn der insgesamt installierte Arbeitsspeicher (MemTotal in /proc/meminfo) unter 3000 MiB liegt. Mit KIOSK=yes lässt er sich erzwingen.

Sie betreiben bereits Home Assistant? KEEPIQ kommt dazu.

KEEPIQ ist darauf vorbereitet, mit Home Assistant auf demselben Raspberry Pi zu koexistieren und Hardware zu nutzen, die bei Ihnen bereits läuft, statt einen zweiten Rechner zu verlangen. Das ist heute ausgeliefert, nicht geplant.

Die Erkennung erfolgt während der Installation: Der Installer bewertet die Hinweise, bevor er irgendetwas schreibt — eine Home-Assistant-Service-Unit, einen laufenden Container, eine Core-Virtualumgebung — und wendet sein Koexistenzprofil automatisch an.

Heute unterstützt

Was das Koexistenzprofil bewirkt

• KEEPIQ läuft auf Port 8080 (8081, falls belegt); Home Assistant behält 8123.
• Der WLAN-Supervisor und der KEEPIQ-SETUP-Hotspot werden nicht installiert, Ihre Netzwerkkonfiguration bleibt exakt so, wie Home Assistant sie eingerichtet hat.
• Ein bereits laufendes PostgreSQL wird weiterverwendet, statt einen zweiten Server zu installieren.
• Die Home-Assistant-Adresse ist vorausgefüllt — Sie fügen nur ein Long-Lived-Token ein.

Typisches Speicherbudget — Pi 4B, 4 GB, ohne Bildschirm

Für eine Installation ohne Bildschirm, bei der Telefone, Tablets und Computer KEEPIQ über das lokale Netz erreichen, lässt ein Pi 4 mit 4 GB beiden Systemen komfortabel Platz.

Hinweis zum Speicher: Wenn Home Assistant, KEEPIQ, die Datenbank und nächtliche Backups alle auf dieselbe SD-Karte schreiben, verwenden Sie eine USB-SSD. Es geht um die Schreibfestigkeit des Flash-Speichers, nicht um Geschwindigkeit — der Installer gibt das als Warnung aus, nie als Blocker.

Home Assistant OS

Home Assistant OS wird als abgeschlossenes Gerät verwaltet und erlaubt bewusst keine Shell-Installationen. Statt diese Architektur zu umgehen, wird KEEPIQ ein eigenes Home-Assistant-Add-on für den nativen Betrieb auf HA OS ausliefern.