INSTALL.md

CloudNet3-Webinterface

Requirement

• CloudNet 3.x and the Rest-Module

• Webserver (or Webspace)

  • PHP 8
  • PHP Extensions: Curl (apt-get install php8-curl)
  • Apache2 Mods: rewrite (a2enmod rewrite)

Download

You can download the latest version from https://project.the-systems.eu/resources/cloudnet3-webinterface
You can download the modul from https://github.com/The-Systems/CloudNet3-WebInterface/releases/download/1.0_alpha4/cloudnet-rest.jar

Installation

1. Delete the cloudnet-rest.jar in CloudNet Modul folder
2. Download the modified cloudnet-rest module
3. Restart CloudNet
4. Load the files into your Webserve
5. Copy the file config/config-sample.php to config/config.php
6. run the command "composer install" (If this doesn't work, go to "Install Composer")
7. Setup the Webserver

Info: The web interface also works on an external Webspace!

Webserver Configuration

Apache2

1. Go to /etc/apache2/sites-available

2. Create a file with the extension .conf (Example: webinterface.conf)

3. Add the following and customize it.

    <VirtualHost *:80>
        ServerName webinterface.domain.com
        DocumentRoot "/var/www/webinterface/public"
   
        <Directory /var/www/webinterface/public>
                AllowOverride All
        </Directory>
   
   
    </VirtualHost>
   

4. Activate the page with

    a2ensite webinterface.conf
   

5. Restart Apache2

    service apache2 restart
   

6. Install SSL Certificate with https://certbot.eff.org/

Install Composer

Debian 10

curl -sS https://getcomposer.org/installer | php
php composer.phar install --no-dev -o

Docker

For the docker setup you just need to have docker and git installed.

Clone the repository

git clone https://github.com/The-Systems/CloudNet3-WebInterface.git

Build the docker image

docker build -t cloudnet-webinterface .

Run the image

The interface will run on port 8080 on the host.

docker run -d --name cloudnet-webinterface \ 
        --port 8080:80 \
        cloudnet-webinterface

GERMAN

Vorraussetzungen

• CloudNet 3.5 and the Rest-Module

• Webserver (oder Webspace)

  • PHP 8
  • PHP Erweiterungen: Curl (apt-get install php8-curl)
  • Apache2 Mods: rewrite (a2enmod rewrite)

Download

Du kannst die aktuelle Version von https://project.the-systems.eu/resources/cloudnet3-webinterface herunterladen
Du kannst hier das Modul von https://github.com/The-Systems/CloudNet3-WebInterface/releases/download/1.0_alpha4/cloudnet-rest.jar herunterladen

Installation

1. Lösche das cloudnet-rest.jar Modul
2. Lade dir das modifizierte cloudnet-rest Moodul herrunter
3. CloudNet Neustarten
4. Lade die Dateien auf deinen Webserver
5. Kopiere die config/config-sample.php in config/config.php und stelle diese ein
6. Führe "composer install" aus (Sollte das nicht funktionieren, befolge "Composer installieren")
7. Richte den Webserver ein

Info: Das Webinterface funktioniert ebenfalls auf einem Externen Webserver/Webspace!

Webserver Configuration

Apache2

1. Gehe zu /etc/apache2/sites-available

2. Erstelle eine Datei mit der Endung .conf (Beispiel: webinterface.conf)

3. Füge das folgende ein und füge deine Daten ein

    <VirtualHost *:80>
        ServerName webinterface.domain.com
        DocumentRoot "/var/www/webinterface/public"
   
        <Directory /var/www/webinterface/public>
                AllowOverride All
        </Directory>
   
   
    </VirtualHost>
   

4. Aktiviere die Seite mit

    a2ensite webinterface.conf
   

5. Starte Apache2 neu

    service apache2 restart
   

6. Sollte der Kommand nicht funktionieren, führe "a2enmod rewrite" aus

7. Installier ein SSL-Zertifikat mit https://certbot.eff.org/

Composer installieren

Debian 10

curl -sS https://getcomposer.org/installer | php
php composer.phar install --no-dev -o

Docker

For the docker setup you just need to have docker and git installed.

Clone the repository

git clone https://github.com/The-Systems/CloudNet3-WebInterface.git

Build the docker image

docker build -t cloudnet-webinterface .

Run the image

The interface will run on port 8080 on the host.

docker run -d --name cloudnet-webinterface \ 
        --port 8080:80 \
        cloudnet-webinterface