SpaceHuddle 0.2.0

SpaceHuddle Installation Package

1. unzip InstallationPackage.zip
2. follow the instructions in the readme.md file
3. The developer documentation can be found at SpaceHuddleDeveloperDocu.pdf.

SpaceHuddle API

SpaceHuddle uses a REST API for exchanging data between the different parts of the application (backend, moderator, client). The API's code is located in the api directory.

Requirements

The SpaceHuddle API requires the following setup:

• a web server: tested with Apache 2.4,
• an SQL database instance: tested with MariaDB 10.4,
• PHP 8.2

Installation and running of the API

1. Copy the api folder on your webserver.
2. Import api/resources/schema.sql into your database. This will create a database called "spacehuddle". Create a MySQL user with full permissions on the database. Enter your database credentials in api/config/env.php (see item 7).
3. Create a public and private key and copy them into the directory api/resources/keys
   • openssl genrsa -out private.pem 2048
   • openssl rsa -in private.pem -outform PEM -pubout -out public.pem
4. Adjust the properties of api/config/env.php

SpaceHuddle frontend

Installation

1. Copy the frontend folder to your domain root directory on the web server.
2. Adjust the properties in the frontend/assets/config.json file. Create your individual MapTiler-key on https://www.maptiler.com/ and set it in config.json file if you want to maptiler as mapserver.
3. Adjust the properties in the frontend/assets/imprint.json file.