Skip to content

Overview

Installation requirements

At least 15 GB of free disk space, 2 CPUs and 4 GB or RAM is required to run Element packaged by Onteon Tech. Those are the minimum requirements. For running chatty Element rooms with many users about 3 times more resources are required.

Supported Operating Systems

Element packaged by Onteon Tech requires Ubuntu Linux 23.10 or newer.

When requiring support, please make sure you run that Linux distribution. If you need Element packaged by Onteon Tech for a different Linux distribution, contact us.

SSL certificates

Installer will need SSL certificate for your organization. Prepare cert and key files before installation. In case you don't have your own SSL certificate, installer can generate self-signed SSL certificate for you, but this is not intended for production use.

PostgreSQL database setup

Installer will install PostgreSQL (required by Element) by default. If you want to use your own PostgreSQL database, please make sure you know PostgreSQL server address, user and password before running installer. Please also set up a database.

Sample database setup is below:

CREATE
  DATABASE dendrite;
CREATE
  ROLE dendrite
  WITH LOGIN ENCRYPTED PASSWORD 'dendrite';
GRANT
  ALL PRIVILEGES
  ON DATABASE dendrite
  TO dendrite;

Installation

Unpack .tar.gz archive file. Enter the root shell by executing sudo -i. Change directory to where the installation script resides, execute the install.bash script and answer the questions.

After installation visit the https://PICKED-HOSTNAME:PICKED-PORT-NUMBER URL (for example: https://element.myorg.org:443) in your browser to login into the Element Web client.

Questions

  • Where will the service be installed? (provide absolute path)
  • What is the external name of this host/domain?
  • Enable systemd support? (yes/no)
  • On what port to run the frontend?
  • Use system postgres? (yes/no, default no)
    • If yes:
      • What is the PostgreSQL server address?
      • What is the PostgreSQL user?
      • What is the PostgreSQL password?
      • What is the PostgreSQL database?
  • What is the path to the SSL certificate?
  • What is the path to the SSL key?

Removal

Firstly run the remove.bash script, then delete the installation directory that was used by the installer. To prevent data loss remove.bash does not do that by default.