Configuration de l'environnement

Une fois récupéré le code source de Trognoncal, la première étape consiste à définir l'environnement d'exécution. Pour cela, on va copier puis ajuster le fichier fourni en exemple par le projet.

Le fichier .env contient de nombreuses informations permettant de définir la manière dont est construite l'infrastructure réseau, elle contient également les informations confidentielles permettant au logiciel de fonctionner.

Copie du fichier de configuration

On copie le fichier à l'aide de la commande :

cp env.example .env

Adaptations principales du fichier de configuration

On va ensuite éditer ce fichier pour l'adapter à l'environnement sur lequel le serveur va fonctionner. Si on n'a qu'un accès ssh à la machine, on peut utiliser la commande :

nano .env

Les adaptations indispensables du fichier sont réparties en quelques blocs clés. Modifiez uniquement les valeurs suivantes :

L'identité de votre site

Ces variables permettent à l'application de savoir comment elle s'appelle et sur quelle adresse internet elle doit répondre.

SITE_DOMAIN : L'adresse que vous tapez dans votre navigateur (ex: agenda.mon-domaine.fr ou localhost si vous testez chez vous).
SITE_NAME : Le nom de votre agenda (ex: Mon Agenda Personnel).

La sécurité de base

SECRET_KEY : C'est le verrou de sécurité de votre application. Remplacez la valeur par défaut par une longue phrase aléatoire avec des chiffres et des lettres. Ne la partagez jamais.
DEBUG : Laissez cette valeur à False en production. Si vous la mettez sur True, le site affichera des informations secrètes sur votre code à la moindre erreur.

Autoriser l'accès

Par sécurité, le serveur rejette par défaut toutes les connexions qui ne viennent pas d'une adresse explicitement autorisée.

ALLOWED_HOSTS : Indiquez ici votre domaine (ex: agenda.mon-domaine.fr.fr,localhost).
CSRF_TRUSTED_ORIGINS : Indiquez votre domaine précédé du protocole sécurisé (ex: https://agenda.mon-domaine.fr.fr). C'est crucial pour que les formulaires de connexion et d'envoi fonctionnent.
CORS_ALLOWED_ORIGINS : Si vous utilisez un site web séparé pour l'affichage (un "frontend"), indiquez son adresse ici pour qu'il ait le droit de parler à l'application.

L'envoi d'e-mails (Notification et mots de passe oubliés)

Cherchez la section # Email settings, enlevez les # au début des lignes pour les activer, et remplissez-les avec les informations fournies par votre hébergeur de mail (ou des services comme Mailjet, SendInBlue, etc.) :

EMAIL_HOST : L'adresse du serveur de mail (ex: smtp.gmail.com).
EMAIL_PORT : Généralement 587 pour une connexion sécurisée.
EMAIL_HOST_USER : Votre adresse e-mail d'envoi.
EMAIL_HOST_PASSWORD : Le mot de passe de cette adresse e-mail.

La base de données Postgres

Par défaut, le fichier contient des identifiants génériques (postgres / postgres). Si votre serveur est accessible directement depuis internet, changez impérativement la valeur de POSTGRES_PASSWORD pour sécuriser vos données.

Étape suivante

À la fin de la configuration de l'environnement, on peut démarrer pour la première fois le serveur.

Démarrage du serveur ➞