Install SUIGEST360 on a VPS

Ubuntu Server — préparation

Les commandes suivantes utilisent Ubuntu Server avec Nginx. Connectez-vous au VPS avec un compte disposant des droits sudo.

sudo apt update
sudo apt upgrade -y

Installer Nginx

sudo apt install nginx -y
sudo systemctl enable nginx
sudo systemctl start nginx
sudo systemctl status nginx

sudo ufw allow 'Nginx Full'

Installer PHP 8.2+

SUIGEST360 nécessite PHP 8.2 ou une version compatible supérieure ainsi que les extensions utilisées par l’application.

sudo apt install php php-fpm php-mysql php-bcmath php-curl php-gd php-mbstring php-xml php-zip php-cli -y

php -v
php -m

Installer MySQL

sudo apt install mysql-server -y
sudo systemctl enable mysql
sudo systemctl start mysql

sudo mysql_secure_installation

Créer la base de données SUIGEST360

sudo mysql

Dans MySQL :

CREATE DATABASE suigest360 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'suigest360'@'localhost'
IDENTIFIED BY 'CHANGE_THIS_STRONG_PASSWORD';

GRANT ALL PRIVILEGES ON suigest360.* TO 'suigest360'@'localhost';

FLUSH PRIVILEGES;

EXIT;

Déployer SUIGEST360

Créez le répertoire du site puis transférez le package SUIGEST360 fourni avec votre licence.

sudo mkdir -p /var/www/suigest360
sudo chown -R $USER:www-data /var/www/suigest360

Configurer les permissions Laravel

cd /var/www/suigest360

sudo chown -R $USER:www-data .
sudo find . -type f -exec chmod 644 {} \;
sudo find . -type d -exec chmod 755 {} \;

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

Configurer Nginx

Remplacez example.com par le domaine utilisé pour votre installation SUIGEST360.

server {
    listen 80;
    listen [::]:80;

    server_name example.com www.example.com;

    root /var/www/suigest360/public;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

ls /run/php/

sudo nginx -t
sudo systemctl reload nginx

Activer HTTPS avec Let's Encrypt

Le domaine doit déjà pointer vers l'adresse IP publique du VPS.

sudo apt install certbot python3-certbot-nginx -y

sudo certbot --nginx -d example.com -d www.example.com

Vérifiez ensuite le renouvellement automatique :

sudo certbot renew --dry-run

Lancer l'installateur SUIGEST360

Ouvrez maintenant le domaine sécurisé dans votre navigateur. SUIGEST360 démarre son assistant d'installation.

L'assistant vérifie ensuite :

• la version PHP et les extensions ;
• les permissions système ;
• la licence SUIGEST360 ;
• la connexion à MySQL ;
• les informations de société ;
• le compte administrateur ;
• le choix entre installation propre et données de démonstration.

Configurer le planificateur Laravel

Après l'installation, configurez le scheduler afin que les tâches planifiées de l'application puissent être exécutées.

crontab -e

Ajoutez :

* * * * * cd /var/www/suigest360 && php artisan schedule:run >> /dev/null 2>&1

Vérification finale

cd /var/www/suigest360

php artisan about
php artisan route:list
php artisan schedule:list

• Vérifiez l'accès HTTPS.
• Connectez-vous avec le compte administrateur.
• Vérifiez les paramètres société.
• Vérifiez la devise, la langue et le fuseau horaire.
• Effectuez une première sauvegarde.

Utiliser Apache à la place de Nginx

SUIGEST360 peut également fonctionner avec Apache. N'installez pas Apache si vous utilisez déjà Nginx pour ce site.

sudo apt install apache2 libapache2-mod-php -y
sudo a2enmod rewrite

Le VirtualHost doit utiliser :

<VirtualHost *:80>

    ServerName example.com
    ServerAlias www.example.com

    DocumentRoot /var/www/suigest360/public

    <Directory /var/www/suigest360/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/suigest360-error.log
    CustomLog ${APACHE_LOG_DIR}/suigest360-access.log combined

</VirtualHost>

sudo apache2ctl configtest
sudo systemctl reload apache2

Pour HTTPS avec Apache :

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d example.com -d www.example.com

Prepare a clean server environment.

VPS installation is recommended when you need full control over PHP, the database, permissions and web server configuration.

• SSH access to the server
• Domain or subdomain pointing to the VPS
• Configured web server
• PHP 8.2 or later
• MySQL or MariaDB
• Valid SUIGEST360 license

Prepare the VPS.

Before installing SUIGEST360, make sure the server is up to date and that a web server and database engine are available.

• Use an account with the required permissions
• Point the domain to the server
• Verify HTTP and HTTPS connectivity
• Prepare SSL before production use

Install PHP and the required extensions.

The SUIGEST360 installer automatically checks the PHP version and required extensions before allowing the installation to continue.

• PHP 8.2 or later
• PDO
• PDO MySQL
• BCMath
• Ctype
• cURL
• DOM
• Fileinfo
• GD
• JSON
• Mbstring
• OpenSSL
• Tokenizer
• XML
• Zip

Create a dedicated MySQL database.

Prepare a database and a user with the necessary permissions. These details will be requested by the installer.

• Database host
• MySQL port, usually 3306
• Database name
• Database username
• Database password

Deploy the SUIGEST360 files.

Place the application files in the website directory and configure the web server so the public document root points to the SUIGEST360 public folder.

• Keep the complete project structure
• Do not expose private Laravel files directly
• Use the public folder as the web root

Allow writing to the required directories.

SUIGEST360 automatically checks that the required Laravel directories exist and are writable.

• storage
• bootstrap/cache

Configure the virtual host.

The domain document root should point to the SUIGEST360 public folder. URL rewriting and PHP processing must also work correctly.

• Document root pointing to public
• HTTPS recommended
• URL rewriting enabled
• PHP-FPM or equivalent configured

Open the guided installer.

Once the server is ready, open your domain in a browser. The installer will guide you through the required order.

• Language selection
• Requirements check
• License validation
• Database configuration
• Company information
• Administrator account
• Initial data selection
• Summary and installation

Verify and activate the license.

The license must be validated before database configuration becomes available. SUIGEST360 associates the installation with the domain and a technical server fingerprint.

• Enter the license code
• Wait for validation confirmation
• Resolve license errors before continuing

Configure the main settings.

Enter the company information that SUIGEST360 will use.

• Company name
• Email
• Phone
• Address
• City
• Country
• Currency
• Currency symbol
• Timezone
• Date format
• Default language

Create the first account.

The first administrator account is created during installation and provides access to the platform.

• Full name
• Valid email address
• Password with at least 8 characters
• Password confirmation

Choose a clean installation or demo data.

Before final installation, choose whether to start with an empty environment or with prepared demonstration data.

• Clean installation for production
• Demonstration data for evaluation and testing

Start the final installation.

Review the summary displayed by the installer and start the installation. SUIGEST360 then creates the required environment and completes the configuration.

• Review the displayed information
• Start the installation
• Do not interrupt the process
• Wait for the completion screen

Perform the first checks.

Once installation is complete, sign in using the administrator account and verify the main settings before using the platform.

• Dashboard access
• Company information
• Currency and timezone
• Language
• User permissions
• Initial backup recommended