1.1. Datenbank

Aktuell werden SQLite3 und MariaDB/MySQL als Datenbanklösungen unterstützt. Für eine einfache und schnelle Installation empfehlen wir die Nutzung von SQLite3. Hier sind keine weiteren Schritte erforderlich – die Datenbank wird automatisch von der App erstellt und ist sofort einsatzbereit.

SQLite ist die bevorzugte Option, da es bei MariaDB/MySQL oft größere Unterschiede zwischen den verschiedenen Versionen gibt, die nicht alle abgedeckt werden können. Die Nutzung erfolgt daher in eigener Verantwortung.

Falls Sie sich für MariaDB/MySQL entscheiden, muss die Datenbanksoftware bereits installiert sein. Die App legt dann eine Datenbank mit dem Namen „QRK“ an, sofern die entsprechenden Berechtigungen zur Erstellung und Verwaltung von Datenbanken vorhanden sind. Bitte stellen Sie sicher, dass die notwendigen Zugriffsrechte konfiguriert sind, bevor Sie die Installation fortsetzen.

 

1.1.1. Installation Linux

Linux 64-Bit AppImage (wiki)

Unterstützte Ubuntu-Versionen

  • Ubuntu 25.04 (Plucky) amd64
  • Ubuntu 24.04 LTS (Noble) amd64
  • Ubuntu 22.04 LTS (Jammy) amd64
  • Ubuntu 20.04 LTS (Focal) amd64
  • Ubuntu 18.04 LTS (Bionic) amd64
  • Ubuntu 16.04 LTS (Xenial) amd64

Unterstützte Debian- & LMDE-Versionen

  • Debian 13 (Trixie) / LMDE 7 (Gigi) amd64
  • Debian 12 (Bookworm) / LMDE 6 (Faye) amd64
  • Debian 11 (Bullseye) / LMDE 5 (Elsie) amd64
  • Debian 10 (Buster) amd64

Unterstützte Linux Mint-Versionen (Ubuntu-basiert)

  • Linux Mint 22 (Wilma, Xia, Zara, Zena) amd64
  • Linux Mint 21 (Vanessa, Vera, Victoria, Virginia) amd64
  • Linux Mint 20 (Ulyana, Ulyssa, Uma, Una) amd64
  • Linux Mint 19 (Tara, Tessa, Tina, Tricia) amd64
  • Linux Mint 18 (Sarah, Sonya, Sylvia) amd64

Hinweis: Nicht-LTS-Versionen von Ubuntu werden maximal sechs Monate unterstützt. Für Ubuntu, Linux Mint und Debian steht ein Repository zur Verfügung. Öffnen Sie ein Terminal und führen Sie die untenstehenden Befehle aus, je nach Ihrer Version.

Das Repository ist auch für Debian und LMDE verfügbar. Für alle anderen Linux-basierten Systeme kann das AppImage verwendet werden. Alternativ besteht die Möglichkeit, den Code selbst zu kompilieren, wobei jedoch die GASTRO- und PRO-Features nicht zur Verfügung stehen.


Installation für Debian ab Vers. 11, Ubuntu ab Vers. 20.04 und LMDE ab Vers. 5:

sudo mkdir -p /etc/apt/keyrings/
sudo mkdir -p /root/.gnupg/

Falls die Verzeichnisse bereits existieren, kann die Info ignoriert werden.

gpg --no-default-keyring --keyring ./temp-keyring.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 410EE8C739BB4452
gpg --no-default-keyring --keyring ./temp-keyring.gpg --export | sudo tee /etc/apt/keyrings/ckvsoft-archive-keyring.gpg > /dev/null
rm ./temp-keyring.gpg

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/ckvsoft-archive-keyring.gpg] https://repo.ckvsoft.at/ckvsoft $(lsb_release -cs)-ckvsoft-stable main" | sudo tee /etc/apt/sources.list.d/ckvsoft-qrk-sources.list

sudo apt-get update
sudo apt-get install qrk

Installation für ältere Debian/Ubuntu-Versionen:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 410EE8C739BB4452

echo "deb https://repo.ckvsoft.at/ckvsoft $(lsb_release -cs)-ckvsoft-stable main" | sudo tee -a /etc/apt/sources.list

sudo apt-get update

sudo apt-get install qrk

Installation für Linux Mint (Ubuntu-basiert) ab Version 20:

sudo mkdir -p /etc/apt/keyrings/
sudo mkdir -p /root/.gnupg/
gpg --no-default-keyring --keyring ./temp-keyring.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 410EE8C739BB4452
gpg --no-default-keyring --keyring ./temp-keyring.gpg --export | sudo tee /etc/apt/keyrings/ckvsoft-archive-keyring.gpg > /dev/null
rm ./temp-keyring.gpg

echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/ckvsoft-archive-keyring.gpg] https://repo.ckvsoft.at/ckvsoft $(env -i bash -c '. /etc/os-release; echo $UBUNTU_CODENAME')-ckvsoft-stable main" | sudo tee /etc/apt/sources.list.d/ckvsoft-qrk-sources.list

sudo apt-get update
sudo apt-get install qrk

Installation für ältere Linux Mint-Versionen:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 410EE8C739BB4452

echo "deb https://repo.ckvsoft.at/ckvsoft $(env -i bash -c '. /etc/os-release; echo $UBUNTU_CODENAME')-ckvsoft-stable main" | sudo tee -a /etc/apt/sources.list

sudo apt-get update

sudo apt-get install qrk

Datenbanktreiber

Je nachdem, welche Datenbank Sie verwenden möchten, sind zusätzliche Treiber notwendig:

  • Für MySQL:
sudo apt-get install libqt5sql5-mysql
  • Für SQLite3:
sudo apt-get install libqt5sql5-sqlite

Updates installieren:

Regelmäßige Updates können Sie wie folgt durchführen:

sudo apt-get update
sudo apt-get upgrade

1.1.2. Installation Windows

  1. Laden Sie die Installationsdatei von SourceForge herunter:
    Zum Download auf SourceForge
  2. Führen Sie die QRK_Installer.exe-Datei aus. Die Installation wird gestartet, und Ihre Registrierkasse ist anschließend einsatzbereit!

Hinweis zum Installationsverzeichnis

Seit Version QRK 1.03 wird die Anwendung standardmäßig nicht mehr im Ordner „Programme“ installiert, da dieser Ordner besondere Eigenschaften besitzt und häufig Probleme bei automatischen Updates verursacht.

Falls Sie QRK dennoch im Ordner „Programme“ (Program Files) installieren möchten, beachten Sie bitte Folgendes:

  • Für das automatische Update muss das Recht „Ändern“ für den QRK-Ordner manuell gesetzt sein.
  • Detaillierte Informationen dazu finden Sie im Handbuch unter Kapitel 1.1.3.1 Windows Automatisches Update.

Falls Fragen auftreten, steht Ihnen die Community im Forum gerne zur Verfügung.

1.1.2.1. Windows automatisches Update

Hinweis zum automatischen Update unter Windows: Damit QRK Updates reibungslos installieren kann, benötigt der Programm-Ordner das Recht „Ändern“. Dies gilt besonders, wenn die Installation im Standard-Verzeichnis „Programme“ erfolgt ist.

Anleitung zur Rechteänderung (basierend auf Windows 7/10/11)

  1. Öffnen Sie den Explorer:
    • Klicken Sie im Startmenü auf Computer (bei Windows 10/11 heißt dieser Punkt „Dieser PC“).
    • Doppelklicken Sie auf das Laufwerk C:.
  2. Navigieren Sie zum Installationsverzeichnis:
    • Öffnen Sie den Ordner Programme oder Programme (x86).
    • Suchen Sie das Verzeichnis QRK Registrier Kasse.
    • Windows 7 Computer Ansicht
  3. Eigenschaften des QRK-Ordners öffnen:
    • Klicken Sie mit der rechten Maustaste auf den Ordner QRK Registrier Kasse und wählen Sie Eigenschaften.
    • Wählen Sie im Fenster den Reiter Sicherheit und klicken Sie auf die Schaltfläche Bearbeiten.
    • Sicherheit Reiter
  4. Berechtigungen für Benutzer anpassen:
    • Wählen Sie im oberen Bereich die Gruppe Benutzer aus.
    • Setzen Sie im unteren Bereich bei Ändern ein Häkchen in der Spalte „Zulassen“.
    • Klicken Sie anschließend auf Übernehmen und bestätigen Sie die Sicherheitsabfragen.
    • Häkchen bei Ändern setzen
    • Übernehmen
    • Bestätigung
  5. Fenster schließen:
    • Klicken Sie auf OK. Ab jetzt verfügt QRK über die notwendigen Berechtigungen für automatische Updates.

Ihre QRK Registrier Kasse ist nun vorbereitet. Falls Sie Fragen haben, steht die Community im Forum zur Verfügung.

1.1.3. Installation MAC

Mac-Version (Eingestellt)

Seit 2024 wird die Mac-Version von QRK nicht mehr aktualisiert, da die erforderliche Entwicklungs-Hardware fehlt und das Interesse gering ist. Wir empfehlen, QRK auf Windows oder Linux zu verwenden.

Installation der letzten verfügbaren Version

  1. Laden Sie die .dmg-Datei von SourceForge herunter.
  2. Öffnen Sie den Finder und navigieren Sie zu „Downloads“, wo Sie die Datei qrk_<Versionsnummer>.dmg finden.
  3. Doppelklicken Sie auf die .dmg-Datei, um sie zu öffnen, und ziehen Sie dann die QRK-App in den Ordner „Programme“ (links im Finder unter Favoriten).

Erster Start

  1. Öffnen Sie den Finder und gehen Sie zu „Programme“.
  2. Klicken Sie mit der rechten Maustaste auf das QRK-Symbol und wählen Sie „Öffnen“.
  3. Falls ein Hinweis erscheint, dass QRK kein zertifiziertes Programm ist, können Sie diese Meldung ignorieren und „Öffnen“ auswählen.

Nun ist Ihre Registrierkasse einsatzbereit und kann wie jede andere Anwendung gestartet werden.

Hinweis zum Autoupdate

Seit QRK Version 1.0 steht auch für den Mac das Auto-Update-Feature zur Verfügung. Beachten Sie jedoch, dass die Mac-Version keine weiteren Updates mehr erhält.

Für Fragen und Unterstützung steht Ihnen die Community gerne im Forum zur Verfügung.