Installation

Ce guide suppose Debian ou Ubuntu, une application dans /var/www/lekalao et un utilisateur système lekalao. Adaptez les chemins à votre serveur.

Récupérer le code

sudo -u lekalao git clone <votre-dépôt> /var/www/lekalao
cd /var/www/lekalao

Installer les dépendances

composer install --no-dev --optimize-autoloader
npm ci
npm run build

Créer la base

sudo -u postgres createuser --pwprompt lekalao
sudo -u postgres createdb --owner=lekalao lekalao

Écrire le .env

cp .env.example .env
php artisan key:generate

Puis, au minimum :

.env

APP_NAME=Lekalao
APP_ENV=production
APP_DEBUG=false
APP_URL=https://lekalao.example.com
APP_LOCALE=fr

DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=lekalao
DB_USERNAME=lekalao
DB_PASSWORD=…

QUEUE_CONNECTION=redis
CACHE_STORE=redis
SESSION_DRIVER=redis
REDIS_HOST=127.0.0.1

MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=…
MAIL_PASSWORD=…
MAIL_FROM_ADDRESS=lekalao@example.com
MAIL_FROM_NAME=Lekalao

Les réglages MAIL_* ne servent qu’aux e-mails de Lekalao lui-même (invitations, mots de passe) tant qu’aucun fournisseur par défaut n’est configuré dans l’interface. Toutes les options sont dans Configuration.

Sauvegardez APP_KEY. Elle chiffre les identifiants des fournisseurs, les secrets des webhooks et les jetons à deux facteurs. La perdre les rend illisibles.

Préparer la base et les fichiers

php artisan migrate --force
php artisan storage:link
php artisan config:cache
php artisan route:cache
php artisan view:cache

Brancher le serveur web

/etc/nginx/sites-available/lekalao

server {
    listen 443 ssl http2;
    server_name lekalao.example.com;
    root /var/www/lekalao/public;

    ssl_certificate     /etc/letsencrypt/live/lekalao.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/lekalao.example.com/privkey.pem;

    client_max_body_size 25M;
    index index.php;

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

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known) {
        deny all;
    }
}

client_max_body_size doit laisser passer les imports (20 Mo) et les médias.

Lancer les processus

Horizon et le cron : voir Processus.

Créer le premier compte

Ouvrez https://lekalao.example.com/register. Seul le premier compte peut s’inscrire ; il devient administrateur de la plateforme et propriétaire de la première équipe. Les autres personnes sont invitées depuis Paramètres → Équipe.

Vérifier

php artisan lekalao:diagnose

Puis suivez le démarrage rapide : fournisseur d’envoi, domaine, adresse postale, première liste.

Données de démonstration

Pour explorer sans rien risquer, sur une installation de test uniquement :

php artisan db:seed --class=DemoDataSeeder

Installer

Exploiter

Vendre le service

Données de démonstration

​Données de démonstration

Données de démonstration