Skip to content

Installation

This guide explains how to install Sentri on a Linux server.

Requirements

Before continuing, make sure your server meets the following requirements:

  • A Linux server (Linux is officially tested and supported)
  • Basic Linux and web hosting experience
  • A web server of your choice (Apache, Nginx, etc.)
  • MariaDB or MySQL
  • PHP 8.3 or newer
  • Git installed on the server

Info

This guide uses /var/www/sentri/ as the installation directory. You can change this to any location you prefer.

Installation

Configure the document root

Sentri stores all publicly accessible files inside the pub/ directory. If your current virtual host document root is: 

/var/www/sentri/
Change it to: 
/var/www/sentri/pub/
After updating the document root, reload or restart your web server.

Download the Sentri files

Run the following commands to download the latest version of Sentri: 

cd /var/www/sentri/

git clone https://gitea.mooij.me/meteo/Sentri.git Sentri

mv Sentri/* .
mv Sentri/.[!.]* . 2>/dev/null

rmdir Sentri

Database setup

Log in to MariaDB/MySQL and create the database and user: 

CREATE DATABASE sentri;  
CREATE USER 'sentri'@'localhost' IDENTIFIED BY 'your_secure_password_here';  
GRANT ALL PRIVILEGES ON sentri.* TO 'sentri'@'localhost';  
FLUSH PRIVILEGES;

Next, import the database schema: 

mariadb -u sentri -p sentri < /var/www/sentri/install.sql
When prompted, enter the password for the sentri database user.

Configuring

Copy the example configuration file: 

cp /var/www/sentri/pub/config-sample.php /var/www/sentri/pub/config.php
Then edit the configuration file and update the database credentials: 
/var/www/sentri/pub/config.php

First Login

Open your website in a browser and log in with the default credentials: 

Username: superuser
Password: changethispassword

Warning

After logging in change the superuser password!

Global settings

Go to Global under Portal Management and rename the portal to your preference.

Next, configure the SMTP connection in Mail under Portal Management so Sentri can send emails.

Finally, enable the modules you want to use in Modules under Portal Management.

Create users and check permissions

Go to the access control and create new users. If you want you could take a look at altering the permissions.

Getting started

After completing the installation, continue with the Getting Started guide to configure and begin using Sentri.