Installation guide added
This commit is contained in:
71
Installation.md
Normal file
71
Installation.md
Normal file
@@ -0,0 +1,71 @@
|
||||
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, Caddy, 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:
|
||||
```bash
|
||||
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:
|
||||
```sql
|
||||
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:
|
||||
```bash
|
||||
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:
|
||||
```bash
|
||||
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!
|
||||
# Getting started
|
||||
After completing the installation, continue with the [[Getting Started]] guide to configure and begin using Sentri.
|
||||
Reference in New Issue
Block a user