Diese Anleitung erklärt, wie der Ninox On-Premises Server mithilfe von Docker auf einem Linux-basierten System installiert und eingerichtet wird

1. Ninox-Server-Image herunterladen

Das Server-Image ist öffentlich im Docker Hub verfügbar. Laden Sie das Ninox On-Premises Image aus dem Repository herunter.

Neueste Version herunterladen:

docker pull ninoxdatabase/ninox-on-premise:latest

Spezifische Version herunterladen (empfohlen für mehr Stabilität):

docker pull ninoxdatabase/ninox-on-premise:3.13.6

Die neuesten verfügbaren Versionen finden Sie im Ninox On-Premises Docker Hub (Docker-Login erforderlich, um die Seite anzusehen).

2. Ninox-Server konfigurieren

Die Konfigurationsdatei des Servers (server-config.json) definiert wichtige einrichtungsspezifische Einstellungen für den Ninox-Server. Standardmäßig ist eine vorkonfigurierte server-config.json-Datei im Ninox-Image enthalten.

Standard-Speicherort:

/usr/local/nxdb/server-config.json

Beispielkonfiguration (server-config.json):

{
"data": "var/nxdb",
"ssl": false, "host": "localhost",
"port": 443,
"bindPort": 80,
"bindInterface": "0.0.0.0",
"redirectPort": 9090,
"workers": 2,
"emailHost": "",
"emailPort": 25,
"emailSecure": false,
"emailUser": "",
"emailPassword": "",
"emailFrom": "",
"emailClient": "",
"snapshots": true
}

3. Optional: Konfiguration anpassen

Um die Standardeinstellungen zu überschreiben, binden Sie eine eigene server-config.json-Datei beim Starten des Containers ein.

Option 1: Datei-Mount für eine einzelne server-config.json

docker container run -d \
  --name {container-name} \
  -p {host-port}:{container-port} \
  -v /mount/path/for/server-config.json:/usr/local/nxdb/server-config.json \
  -v NX-DATA:{data-path-or-use-default-/var/nxdb} ninoxdatabase/ninox-on-premise

Ersetzen Sie den Platzhalter innerhalb von {} (einschließlich der geschweiften Klammern) mit den entsprechenden Werten.

Option 2: Verzeichnis-Mount für den Konfigurationsordner mit server-config.json-Datei

docker container run -d \
  --name {container-name} \
  -p {host-port}:{container-port} \
  -v /mount/path/for/config/:/usr/local/nxdb/config \
  -v NX-DATA:{data-path-or-use-default-/var/nxdb} ninoxdatabase/ninox-on-premise

Ersetzen Sie den Platzhalter innerhalb von {} (einschließlich der geschweiften Klammern) mit den entsprechenden Werten.

Hinweis: Eine detaillierte Erklärung der Konfigurationsoptionen finden Sie in der Dokumentation zur Beispiel-Konfigurationsdatei.

4. Ninox-Server-Container starten

Mit docker run (manueller Start)

Ohne Proxy und ohne spezifische Server-Konfiguration (Basis-Einrichtung)

docker container run -d \
  --name nxdb \
  -v NX-DATA:/var/nxdb \
  -p 80:8080 ninoxdatabase/ninox-on-premise

In dieser Einrichtung verwendet der Ninox-Server die integrierte Konfigurationsdatei. Änderungen an der Server-Konfiguration über die UMS-Schnittstelle sind nicht persistent. Zugriff auf Ninox über http://localhost/.

Mit einem Proxy zwischen Client und Server

docker container run -d \
  --name nxdb \
  -p 6999:8080 ninoxdatabase/ninox-on-premise \
  -v NX-DATA:/var/nxdb \
  -v {path-to-server-config.json}:/usr/local/nxdb/server-config.json ninoxdatabase/ninox-on-premise-

Geben Sie das Server-Konfigurations-Mount an, da es die Standardkonfiguration überschreibt. Zugriff auf Ninox über http://{host-specified-in-server-config-json}. Ersetzen Sie den Platzhalter innerhalb von {} (einschließlich der geschweiften Klammern) mit den entsprechenden Werten.

Stellen Sie sicher, dass die folgenden Kriterien erfüllt sind:

• Der host-Parameter ist korrekt konfiguriert.

• Der HostPort in der -p-Direktive des Containers ist korrekt.

• Der Proxy ist so eingerichtet, dass eingehende Anfragen an den richtigen Port weitergeleitet werden.

5. SSL konfigurieren

Ohne Proxy

Es wird empfohlen, SSL auf dem Ninox-Server zu konfigurieren. Aktualisieren Sie die ssl-Eigenschaft in der Datei server-config.json und mounten Sie ein zusätzliches Verzeichnis mit SSL-Zertifikaten, zum Beispiel:

/usr/local/nxdb/certificates

Stellen Sie sicher, dass die folgenden Kriterien erfüllt sind:

• redirectPort ist auf 80 gesetzt, um alle HTTP-Anfragen an den SSL-aktivierten Port weiterzuleiten.

• port ist auf 443 gesetzt.

• bindPort ist auf einen verfügbaren Wert gesetzt, zum Beispiel 8443.

Mit Proxy

SSL sollte direkt auf dem Proxy konfiguriert werden.

6. Login auf dem Server

Loggen Sie sich mit den folgenden Standard-Login-Daten ein:

• Benutzername: root

• Passwort: root

7. Ändern der Standard-Login-Daten

Aus Sicherheitsgründen sollten Sie den Standard-Benutzernamen und das Passwort ändern:

1. Loggen Sie sich bei Ninox und klicken Sie auf das Zahnrad-Symbol in der oberen Leiste.

2. Wählen Sie im Dropdown-Menü Ninox-Einstellungen.

   

3. Gehen Sie in den Ninox-Einstellungen zu Nutzer.

   

4. Wählen Sie den Account root aus.

5. Ersetzen Sie die Standard-Login-Daten durch Ihre E-Mail-Adresse und ein sicheres Passwort.

6. Klicken Sie auf Speichern, um die Änderungen zu übernehmen.

8. Lizenzdatei anwenden

So wenden Sie Ihre Ninox-Lizenz an:

1. Laden Sie die Ninox-Lizenzdatei (ninox.license) aus Ihrer E-Mail herunter.

2. Gehen Sie in den Ninox-Einstellungen zu Abonnements.

   

3. Klicken Sie auf Ninox-Lizenz hochladen und wählen Sie die heruntergeladene Datei ninox.license aus.

4. Klicken Sie auf Speichern und neu starten, um die Lizenz anzuwenden.

9. Zugriff auf den Ninox-Server

• Auf einem lokalen Rechner:

  • http://localhost

  • Beispiel: http://localhost:8080/.

• Auf einem Remote-Server:

  • http://{server-IP}

  • Ersetzen Sie {server-IP} durch die tatsächliche Adresse, zum Beispiel http://192.168.1.10.

Fehlerbehebung und Diagnose

Um Ihre Docker-Festplattennutzung zu überprüfen, sehen Sie unten im Docker-Desktop-Fenster nach.

Wenn Sie eine hohe Festplattennutzung oder Leistungsprobleme feststellen, führen Sie die folgenden Schritte aus, um den Docker-Build-Cache zu bereinigen.

1. Aktuelle Festplattennutzung anzeigen:

docker system df -v

1. Ungenutzten Build-Cache, Container und verwaiste Images löschen:

docker builder prune

Zusätzliche Hilfe

Falls Sie Probleme haben oder weitere Unterstützung für Ihr Ninox On-Premises benötigen, kontaktieren Sie unser Support-Team.