Installation

Installation Guide

To install FURTHRmind on your premises, we exclusively support installation via Docker. This method ensures seamless and scalable deployment by encapsulating FURTHRmind within a Docker container. Additionally, please review our technical requirements to facilitate a smooth setup process.

Docker

We utilize Docker Compose to streamline the deployment process, enabling the orchestration of multiple Docker containers as defined in our docker-compose.yml file. You can download and install Docker Compose by following the official instructions available at Docker’s documentation page.

MongoDB

Data storage for this system is managed by a MongoDB instance, which the server application must be able to access. It’s not mandatory for MongoDB to be installed on the same physical or virtual machine as the server application.

You can install a MongoDB on your own, or you can use our docker-compose.yml file to create a working MongoDB.

Make sure you use MongoDB 6 or higher.

S3 Storage

File storage for this system is managed by a MinIO S3 instance. You can install a MinIO service on your own, or you can use our docker-compose.yml file to create a working minio service.

RedisDB

To handle background tasks, alleviating the load on the main server and ensuring its constant availability, we use a RedisDB Database to receive tasks from the main server application. You can install a RedisDB service on your own, or you can use our docker-compose.yml file to create a working RedisDB service.

OnlyOffice

If you have a FURTHRmind Premium Edition and you want to use the Office integration, please note that the OnlyOffice Docs Server must be installed separately. The community version is free and supports up to 20 concurrent connections. For more users, you will need to purchase a license for ONLYOFFICE Docs Enterprise Edition.

For installing OnlyOffice, please refer to the OnlyOffice Docs documentation. This includes instructions for using docker-compose (Running ONLYOFFICE Docs using Docker Compose - ONLYOFFICE) and installation on Debian or Ubuntu systems (Installing ONLYOFFICE Docs using Docker Compose - ONLYOFFICE).

Prepare docker-compose.yml

The provided docker-compose files simplifies the installation process by including all necessary services. It configures MongoDB and RedisDB; however, you can choose to use external versions of these services by removing their sections from the file. Additionally, it includes MinIO, an S3-compatible object storage server, for file storage management. If you have an external S3 storage solution or prefer to store files as blobs in MongoDB, you can omit this component.

This file also includes a “watchtower” service, which automatically updates all container images to the latest versions, ensuring your software remains up-to-date with minimal manual intervention.

Community Edition:

Premium Edition:

Note: To use a regular premium edition, you will need a registered license.

Install FURTHRmind

  1. Preparation:
    First, navigate to the /opt/ directory and create a folder named “furthrmind”:

    cd /opt/
mkdir furthrmind

    Next, move into the furthrmind directory, create an empty docker-compose.yml file, and paste the contents of the docker-compose.yml as prepared in the chapter titled “Prepare docker-compose.yml”:

    cd furthrmind
sudo nano docker-compose.yml

  2. Start FURTHRmind:

    docker compose up

    When you initiate the FURTHRmind server for the first time, please allow some time for the initial setup to complete. We include a template database that comes pre-populated with predefined units and our Maskproject data for your convenience. After the startup you should see something like this:

    Go to your furthrmind website and check if everything works. If everything works, stop the docker container and rerun it in daemon mode. 

    docker compose down
docker compose up -d

  3. First login:
    For your first login, use the following credentials. Don’t forget to change the email address and the password.

    email: [email protected]
password: admin