Access control documented

This commit is contained in:
Marco Mooij | DigiState
2026-05-15 13:43:56 +02:00
parent 8e4ea9d4a0
commit db2b6e62b8
11 changed files with 95 additions and 24 deletions

View File

@@ -1,19 +1,20 @@
# Installation
This guide explains how to install Sentri on a Linux server.
# Requirements
## 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, Caddy, etc.)
- 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
## Installation
## Configure the document root
### Configure the document root
Sentri stores all publicly accessible files inside the `pub/` directory.
If your current virtual host document root is:
```
@@ -24,7 +25,7 @@ Change it to:
/var/www/sentri/pub/
```
After updating the document root, reload or restart your web server.
## Download the Sentri files
### Download the Sentri files
Run the following commands to download the latest version of Sentri:
```bash
cd /var/www/sentri/
@@ -36,7 +37,7 @@ mv Sentri/.[!.]* . 2>/dev/null
rmdir Sentri
```
## Database setup
### Database setup
Log in to MariaDB/MySQL and create the database and user:
```sql
CREATE DATABASE sentri;
@@ -50,7 +51,7 @@ 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
### Configuring
Copy the example configuration file:
```bash
cp /var/www/sentri/pub/config-sample.php /var/www/sentri/pub/config.php
@@ -59,7 +60,7 @@ Then edit the configuration file and update the database credentials:
```
/var/www/sentri/pub/config.php
```
### First Login
#### First Login
Open your website in a browser and log in with the default credentials:
```
Username: superuser
@@ -68,13 +69,13 @@ Password: changethispassword
> [!WARNING]
> After logging in change the superuser password!
### Global settings
#### Global settings
Go to [[Global|Global]] under Portal Management and rename the portal to your preference.
Next, configure the SMTP connection in [[Mail|Mail]] under Portal Management so Sentri can send emails.
Finally, enable the [[index#Modules|modules]] you want to use in [[Portal Management/Settings/Modules|Modules]] under Portal Management.
### Create users and check permissions
#### Create users and check permissions
Go to the
### Getting started
#### Getting started
After completing the installation, continue with the [[Getting Started]] guide to configure and begin using Sentri.