Installation des Forms Add-on

1. Installation des Forms Add-on#

Installation der Lizenz#

Wie i-doit lizenziert wird findest du im Artikel Lizenzierung.

Download und Installation des Forms Add-on#

Eine detaillierte Beschreibungen bezüglich Download, Installation, Updates usw. liefert der Artikel i-doit Add-ons.

2. Installation MongoDB#

Die Systemvoraussetzungen von MongoDB findest du hier. Außerdem stellt MongoDB eine Checkliste für den Einsatz im Betrieb zur Verfügung.

Installiere zuerst gnupg auf der Konsole:

1

sudo apt-get install gnupg curl

Importiere den Public Key für das mongodb-org Repository:

1
2
3

curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \
sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
--dearmor

Erstelle eine sources-Datei für MongoDB:

1

echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] http://repo.mongodb.org/apt/debian bookworm/mongodb-org/8.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

Aktualisiere die lokale Package-Database:

1

sudo apt-get update

Installiere die neueste stabile Version von MongoDB:

1

sudo apt-get install -y mongodb-org

Lade die Services neu:

1

sudo systemctl daemon-reload

Damit MongoDB beim nächsten Systemstart gestartet wird:

1

sudo systemctl enable mongod

Starte MongoDB:

1

sudo systemctl start mongod

3. Installation NodeJS#

Ein manueller Download ist hier möglich. Eine Anleitung ist dort auch zu finden.

Für den nächsten Schritt benötigst du cURL:

1

sudo apt-get install curl

NodeJS installierst du via Package Manager. Verwende den Code, der über https://nodejs.org/en/download angezeigt wird:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"

# Download and install Node.js:
nvm install 22

# Verify the Node.js version:
node -v # Should print "v22.14.0".
nvm current # Should print "v22.14.0".

# Verify npm version:
npm -v # Should print "10.9.2".

Installiere NodeJS:

1

sudo apt-get install -y nodejs

4. Konfiguration das Forms Backend#

Navigiere in den Forms-Backend-Unterordner innerhalb der i-doit-Installation (der Pfad kann abweichen):

1

cd /var/www/html/src/classes/modules/forms/backend/

Erstelle eine Kopie der Konfiguration (der Apache-Benutzer kann je nach OS abweichen). Beispiel für Debian/Ubuntu:

1

sudo -u www-data cp .env.dist .env

Editiere die .env mit einem Texteditor wie vi oder nano:

1

sudo nano .env

Es muss ein FORMS_SECRET gesetzt und die Datei gespeichert werden.

Als nächstes erstellst du eine Instanz. Setze zunächst die Ausführungsrechte für die run.sh:

1

sudo chmod +x run.sh

Führe die run.sh aus:

1

sudo ./run.sh instance:create {Benutzername} {Apikey}

Setze die Ausführungsrechte für die forms-service.sh:

1

sudo chmod +x forms-service.sh

Erstelle den systemd-Service für das Forms-Backend. Dieser wird automatisch aktiviert und gestartet:

1

sudo ./forms-service.sh

Damit ist die Installation abgeschlossen.

5. Konfiguration in i-doit#

Damit das Frontend mit dem Backend kommunizieren kann, hinterlegst du den zuvor verwendeten Benutzernamen und den APIkey in der Verwaltung unter Einstellungen für [Mandanten-Name] hinterlegen. Aufgerufen werden diese über Verwaltung → [Mandanten-Name] Verwaltung → Einstellungen für [Mandanten-Name] → Forms Add-on.

Weiter mit "Forms Add-on verwenden"