Skip to content

Mit Docker initialisieren


Kurzversion: imperia CMS initialisieren und starten#

Dies ist die Kurzversion der Anleitung, die funktioniert, sobald Sie Docker für imperia CMS auf Ihrem Server grundsätzlich eingerichtet haben. Wenn Sie das noch nicht getan haben, lesen Sie zunächst die Anleitung: Docker für imperia CMS erstmalig einrichten und starten.

Schritt 1: imperia Hauptverzeichnis initialisieren#

imperia-docker init

Am Ende des Initalisierungsdialogs erhalten Sie das Superuser-Passwort. Notieren Sie es sich.

Schritt 2: Docker-Image starten#

imperia-docker serve

imperia CMS kann im Anschluss unter dem Port 2404 aufgerufen werden. Auf dem Server selbst also unter der URL: http://127.0.0.1:2404/imp/.

Docker für imperia CMS erstmalig einrichten und starten#

In dieser Schritt-für-Schritt-Anleitung richten Sie Docker für imperia CMS erstmalig ein. Am Ende der Anleitung wird zusätzlich noch beschrieben, wie der Alias imperia-docker anlegt wird, damit Sie beim nächsten mal die Kurzversion nutzen können.

Schritt 1: Docker installieren#

Unter https://docs.docker.com/install/ finden Sie Installationsanleitungen für sämtliche Betriebssysteme. Darunter auch eigenständige Anleitungen für Ubuntu, CentOs, Windows und viele weitere mehr.

Schritt 2: Bei der imperia Docker-Registry anmelden#

Zusammen mit der Auslieferung des Lizenzschlüssels für imperia 11 erhalten Sie vom imperia Support auch einen persönlichen Zugang zu unserer Docker-Registry, bestehend aus einem Benutzernamen und einem Passwort.

So melden Sie sich über das Terminal mit Docker bei Ihrem Konto auf der Docker-Registy von imperia an:

docker login --username BENUTZERNAME --password PASSWORT https://docker.imperia.cloud:16448

Schritt 3: imperia Hauptverzeichnis initialisieren#

In diesem Schritt geht es darum, ein Hauptverzeichnis für imperia CMS einzurichten, das alle Daten enthält, die nicht zum Kern der Software gehören. Also Benutzerdaten, Templates, generierte Dateien, etc. Der Standard-Pfad in der nativen Installation war hier immer /var/www/imperia/dev.

Navigieren Sie mit dem Terminal also zu diesem Verzeichnis oder legen Sie ein leeres Verzeichnis an, falls es noch nicht exisitert.

Führen Sie diesen Befehl im Terminal aus, um das Verzeichnis für imperia CMS zu initialisieren:

docker run --name imperia -p 2404:2404 --rm --env IMPERIA_HOST_PATH="$(pwd -P)"  --user `id -u` -it -v "$(pwd):/www" docker.imperia.cloud:16448/imperia:latest init

Hinweis

Die URL docker.imperia.cloud:16448/imperia:latest kann abhängig von Ihrer Lizenz etwas abweichen. Die genaue URL erhalten Sie zusammen mit den Lizenzunterlagen vom imperia Support.

Am Ende des Initalisierungsdialog erhalten Sie das Superuser-Passwort. Notieren Sie es sich. Hier ein Beispiel für die Ausgabe des Dialogs:

**************************************************************************
**************************************************************************
** The superuser password for this installation is:                     **
**                                                                      **
**    KA7zA1Ers                                                         **
**                                                                      **
** You can change it to your taste once you have logged in.             **
**************************************************************************
**************************************************************************

Schritt 4: Docker-Image starten#

Um das so eingerichtete imperia System zu starten, führen Sie danach in demselben Verzeichnis den folgenden Befehl aus:

docker run --name imperia -p 2404:2404 --rm --env IMPERIA_HOST_PATH="$(pwd -P)"  --user `id -u` -it -v "$(pwd):/www" docker.imperia.cloud:16448/imperia:latest serve

Entsprechend des oben erstellen Dockeraufrufs, ist das System im Anschluss unter dem Port 2404 verfügbar.

Hinweis

Die URL docker.imperia.cloud:16448/imperia:latest kann abhängig von Ihrer Lizenz etwas abweichen. Die genaue URL erhalten Sie zusammen mit den Lizenzunterlagen vom imperia Support.

Optional: Alias imperia-docker anlegen#

Um den langen Docker-Befehl nicht jedes mal ausschreiben zu müssen, ist es ratsam, sich einen sogenannten Alias anzulegen.

Anschließend können Sie die in der Kurzanleitung benutzten Befehle imperia-docker init und imperia-docker serve ausführen.

Fügen Sie dazu folgenden Befehl in Ihrer Alias-Datei hinzu. Auf einem Standard-Linux-System finden Sie diese Datei unter ~/.bash_profile oder ~/.bashrc.

alias imperia-docker='docker run --name imperia -p 2404:2404 --rm --env IMPERIA_HOST_PATH="$(pwd -P)"  --user `id -u` -it -v "$(pwd):/www" docker.imperia.cloud:16448/imperia:latest'

Wie geht es von hier aus weiter?#

Wenn imperia CMS jetzt bei Ihnen im Docker-Container läuft und über den Browser aufgerufen werden kann, dann können Sie sich jetzt als Superuser anmelden und mit der Administration des Systems loslegen. Hier geht es für Sie weiter:

Administrationsdokumentation

Sie möchten imperia CMS nicht nur via Docker betreiben, sondern auch eine bestehende Installation auf Docker migrieren? Hier geht es für Sie weiter:

imperia CMS auf Docker migrieren

Das Docker-Image von unserer Registry reicht Ihnen nicht aus und Sie wollen es erweitern und selbst bauen. Hier geht es für Sie weiter:

Docker-Image selbst bauen