Installation

Der schnellste Weg: ein fertiges Abbild für linux/amd64 und linux/arm64, signiert und mit Lizenzprüfung gebaut. Läuft überall, wo Docker läuft - auch auf macOS und Windows mit Docker Desktop.

1. Abbild holen

   Die Marke latest zeigt auf die neueste Fassung; jede Fassung gibt es auch unter ihrer Nummer, etwa 1.12.427.

   bash

   docker pull kuomar/kuonensql:latest

2. Starten

   Die Daten liegen im benannten Volume kuonensql-daten und überleben jeden neuen Container. Ein benanntes Volume statt eines Ordners: es gehört gleich dem Benutzer, unter dem der Server im Abbild läuft.

   bash

   docker run -d --name kuonensql --restart unless-stopped \
     -p 1433:1433 -p 6379:6379 \
     -e KUONENSQL_SA_PASSWORD='<Ihr-Kennwort>' \
     -v kuonensql-daten:/app/data \
     kuomar/kuonensql:latest

3. Prüfen

   Nach wenigen Sekunden meldet das Protokoll „TDS-Server lauscht auf [::]:1433“.

   bash

   docker logs kuonensql

4. Weitere Zugänge einschalten (wenn gewünscht)

   MySQL, MariaDB, PostgreSQL und GraphQL sind aus, bis ein Port gesetzt ist - dieselben Daten, nur eine andere Tür. Den Container dafür mit diesen Angaben zusätzlich neu anlegen:

   bash

   -p 3306:3306 -e KUONENSQL_MYSQL_PORT=3306 \
   -p 5432:5432 -e KUONENSQL_POSTGRESQL_PORT=5432

5. Oder mit Compose

   compose.yaml in einen leeren Ordner legen. Ohne Kennwort in .env bricht der Aufruf ab, statt einen offenen Server zu starten.

   bash

   echo "KUONENSQL_SA_PASSWORD=<Ihr-Kennwort>" > .env
   docker compose up -d

Die Dateien

compose.yaml

Gehört nach ein leerer Ordner, daneben eine Datei .env. Im Quellstand: dist/dienst/docker/compose.yaml.

# KuonenSQL mit Docker Compose, aus dem veröffentlichten Abbild (U19.10) - ohne Quellstand, ohne Bauen.
# In einen leeren Ordner legen, daneben eine Datei .env mit KUONENSQL_SA_PASSWORD=<Kennwort>, dann: docker compose up -d
# (docker/docker-compose.yml im Repo ist die Fassung für Entwickler: sie baut das Abbild aus dem Quellstand.)

services:
  kuonensql:
    image: kuomar/kuonensql:latest
    container_name: kuonensql
    restart: unless-stopped
    # Der Server schreibt beim Beenden einen Kontrollpunkt; so lange wartet Docker, bevor es hart beendet.
    stop_grace_period: 60s
    ports:
      - "1433:1433"   # T-SQL (SSMS, sqlcmd, EF Core)
      - "1333:1333"   # KSQL (TDS, der Kern mit ehrlicher Kennung)
      - "6379:6379"   # Redis
      - "3306:3306"   # MySQL 8.4
      - "5432:5432"   # PostgreSQL 17
    environment:
      # Ohne Kennwort bricht der Aufruf ab, statt einen offenen Server zu starten.
      KUONENSQL_SA_PASSWORD: ${KUONENSQL_SA_PASSWORD:?KUONENSQL_SA_PASSWORD in .env setzen}
      KUONENSQL_KSQL_PORT: "1333"
      KUONENSQL_MYSQL_PORT: "3306"
      KUONENSQL_POSTGRESQL_PORT: "5432"
      KUONENSQL_SORTIERUNG: ${KUONENSQL_SORTIERUNG:-SQL_Latin1_General_CP1_CI_AS}
    volumes:
      # Ein benanntes Volume statt eines Ordners: es gehört gleich dem Benutzer, unter dem der Server im Abbild läuft.
      - kuonensql-daten:/app/data

volumes:
  kuonensql-daten:

Im Betrieb

docker logs -f kuonensql

docker stop kuonensql
docker start kuonensql

docker pull kuomar/kuonensql:latest
docker rm -f kuonensql
docker run -d --name kuonensql --restart unless-stopped \
  -p 1433:1433 -p 6379:6379 \
  -e KUONENSQL_SA_PASSWORD='<Ihr-Kennwort>' \
  -v kuonensql-daten:/app/data \
  kuomar/kuonensql:latest

docker compose pull
docker compose up -d

docker cp kuonensql:/app/data/backup ./sicherung

Gut zu wissen

• Docker wartet beim Stoppen 10 Sekunden, Compose 60 (stop_grace_period). In der Zeit schreibt der Server seinen Kontrollpunkt; ein hartes Ende kostet keine Daten, nur einen längeren nächsten Start.
• Das Kennwort gilt ab dem ersten Start und bleibt als Hash im Volume. Später ändert es ALTER LOGIN sa WITH PASSWORD = '…'.