GoFAST Community : Install

Note

In case of problems you can ask your questions on the forums: https://community.ceo-vision.com

Instructions (by container)

Note

If you got to this page from the GoFAST Community form, you can skip directly to step 2

Step 1 : Go to https://gofast-ng.ceo-vision.com/

Once you have completed the link form above and clicked on the link sent to you by e-mail, please proceed as follows :

When you go to the download interface, a configuration page appears, it consists of 4 steps :

– Configuring the domain name

– Configuring the SSL certificate

– The configuration of the SMTP server

– The configuration of the platform administrator account

Step 2 : Configuring the Domain Name

On this screen you configure the name and domain of your GoFAST Community :

  1. Site name : This is the name that will appear in the tabs for example

  2. Full Domain Name : This is your organization’s usual domain name e.g. gofast.company-xyz. com

Step 3 : Configuring the SSL Certificate

You must load x509 base64-encoded certificates corresponding to the domain name entered above.

You must provide :
  1. the public key of your certificate (.pem or .crt)

  2. the private key corresponding to the certificate (.key)

Note

If you do not know what it is, these certificates take the form of two files to ask your IT department

Warning

At the moment this interface does not allow to generate self-signed certificates, if you want to generate one for test use only, you can use an online tool like https://regery.com/en/security/ssl-tools/self-signed-certificate-generator

Step 4: SMTP Server Configuration

This 4th step allows you to configure the SMTP server used by GoFAST to send emails. The required fields are :

  1. SMTP Server: The domain name or IP of your SMTP server

  2. Username: If authentication is required, the username

  3. Password : If authentication is required, the password

  4. Security : To be filled in according to the security protocol used

  5. SMTP Port : The port of your SMTP server

Note

If you do not have an SMTP server, you can specify an SMTP server that does not exist (Example: smtp.example.org)

Step 5 : Creating the Administrator User

Configuration Functional Administrator

The section Admin Account Configuration allows you to enter the credentials of the first account created on GoFAST that you will use to log in.

You must choose the username, password and email address for this account.

Warning

It is not possible to choose ‘admin’ for the username which is a reserved account for the technical administrator account (see below).

Configuration Technical Administrator

The section Technical Password is reserved for the technical administrator account of the platform. You can set each password by unchecking Use technical password for all services.

As a user you will not normally have to use this technical account.

Step 6 : Confirm the configuration

Warning

Before clicking on “Get Compose”, please check all fields before proceeding to download.

Once these steps are completed, a page appears with a summary. If everything is correct, validate the configuration.

After validating the download, it will upload two files to a .zip archive:

  • An .env containing all the variables entered

  • A compose.yaml file containing the description of the containerized GoFAST application

Note

Il sera possible prochainement de re charger ces fichiers pour obtenir les mises à jour de votre plateforme GoFAST Community

Step 7: Install your platform

Caution

GoFAST is a business application and requires a server (mini 4vcpu,12GB RAM,SSD recommended). Use on a simple PC with Podman Desktop or Docker Desktop is therefore not recommended.

Note

To access the application, declare its domain name (entered in step 2) together with its IP address in your computer’s hosts file (https://www.digdeo.fr/articles/sys-admin/modifier-fichier-etc-hosts-windows-mac-linux) or in the company’s DNS

Note

Many technical operations will be carried out as well as service starts, which may take more or less time depending on the capabilities of the server. The estimated time for first start-up is between 10 and 30 min.

On a Linux machine - RedHat (Recommended: AlmaLinux or CentOS)

  • Install podman, podman-compose and unzip packages using the appropriate package manager (yum or dnf depending on your version)

dnf install podman-compose podman unzip
yum install podman-compose podman unzip
  • Unzip and copy the .env and compose.yaml files to the folder of your choice

mkdir /opt/gofast
cd /opt/gofast
unzip gofast-community.zip
  • Instance your GoFAST Community

podman-compose up -d
  • Follow the progress of your installation

podman logs -f gofast-ng-drupal
podman logs -f gofast-ng-alfresco
podman logs -f gofast-ng-mysql
podman logs -f gofast-ng-....

Note

Once the command “podman logs -f gofast-ng-drupal” returns the hand, it means that the installation is complete.

On Windows with Docker Desktop and Portainer

Note

When installing keep the default settings, including the use of WSL 2. A restart of Windows will be required.

Caution

After restarting Windows when opening Docker Desktop, if the message “Docker Desktop requires a newer WSL kernel version” is displayed, follow the “Update the WSL Kernel” procedure in the “Known Issues” section.

  • In Docker Desktop click on “Add Extensions” in the left menu and install the “Portainer” extension. This extension will allow you to initialize GoFAST Community in a simple way.

  • Open the extension “Portainer” in the left menu and click on “Get started”

  • Dans Portainer sélectionner l’environnement “local” en cliquant ci-dessus

  • In Portainer click on the “Stacks” menu (in the small vertical menu between the left menu and the main window)

  • Add a new stack using the “+ Add Stack” button

  • Give it a name, say “gofast-community”

  • Sélectionnez la méthode “Upload”

  • In “Upload”, load your compose.yaml

  • In “Environment variables” click on “Load variables from .env file”

  • To finalize the instantiation, click at the bottom on “Deploy the stack”

Caution

This process once started will download all images of GoFAST applications, this process may take time. Do not leave or change menu while you see “Deployment in progress…”

Instructions (for AWS)

This installation method will be back soon.

Instructions (per image)

This installation method will be back soon.

Let’s go!

Go to the domain name you have chosen https://gofast.entreprise-xyz.com.

You need to create some users and collaborative spaces (and subspaces).

Spaces can be of different types, “Organization” (departments, …), “Groups” (projects, …), “Extranet” (partners, clients, …). See the online documentation here: https://gofast-docs.readthedocs.io/fr/latest/docs-gofast-users/doc-gofast-guide-utilisateurs.html#gerer-un-espace-collaboratif-groupe

Dans les sous-espaces créés, ajoutez des membres qui pourront avoir accès au contenu de cet espace. Ajoutez des sous-espaces si nécessaire.

Add content using drag-and-drop in the “GoFAST File Browser”

You’re ready to go!

Known issues

Updating the WSL Kernel

If a WSK kernel update is required, go to https://docs.microsoft.com/windows/wsl/wsl2-kernel

Download the proposed “WSL2 Linux Kernel Update Package” and run it.

You can then restart Docker Desktop.