Installation web
Après avoir démarré Sayrud avec un binaire, Docker Compose ou Kubernetes, ouvrez http://server-address:2830/setup. Avant l’installation, la page d’accueil redirige également vers cette page.
L’installation comporte quatre étapes : vérification, base de données, administrateur et fin. Vous pouvez changer de langue en haut à droite.
Vérifier votre identité
Si aucun jeton n’est spécifié, les journaux de démarrage affichent Setup token: et un lien d’installation contenant le jeton. Copiez-le dans la page et cliquez sur « Vérifier ». Pour un déploiement distant, remplacez localhost dans le lien par l’adresse réelle.
| Méthode de déploiement | Où consulter les journaux |
|---|---|
| Processus au premier plan | Terminal actuel |
| systemd | sudo journalctl -u sayrud -n 100 --no-pager |
| Docker Compose | docker compose logs --tail=100 sayrud |
| Kubernetes | kubectl -n sayrud logs deployment/sayrud --tail=100 |
Si SAYRUD_SETUP_TOKEN est défini, saisissez sa valeur. Les instructions K8s utilisent cette méthode ; le jeton se trouve dans le fichier local utilisé pour créer le Secret.
Un jeton personnalisé doit contenir au moins 16 caractères après suppression des espaces et des traits d’union. Vous pouvez le générer avec openssl rand -hex 24. La vérification ignore la casse, les espaces et les traits d’union.
Si le jeton n’est pas fixe, le redémarrage du processus pendant l’installation en génère un nouveau. Récupérez-le dans les journaux les plus récents. Ne partagez le jeton ou le lien qui le contient qu’avec la personne chargée de l’installation ; les points d’accès d’installation se ferment après la création de l’administrateur.
Configurer les bases de données
Pour une nouvelle installation, renseignez les informations suivantes :
| Service | Champs |
|---|---|
| PostgreSQL | Hôte, port, nom de la base, utilisateur, mot de passe, mode SSL |
| Redis | Adresse au format hôte:port, avec un utilisateur et un mot de passe facultatifs |
Les connexions partent du processus Sayrud, et non de l’ordinateur sur lequel le navigateur est ouvert. La configuration Docker Compose utilise postgres et redis:6379 ; K8s utilise les noms de Service internes au cluster ou des domaines externes accessibles.
Les modes SSL de PostgreSQL sont « Sans chiffrement », « Chiffré », « Chiffré, vérifier l’AC » et « Chiffré, vérifier l’AC et le nom d’hôte ». Choisissez le mode exigé par votre service de base de données. Pour vérifier les certificats, l’environnement d’exécution doit aussi faire confiance à l’AC concernée.
Cliquez sur « Tester la connexion », vérifiez que PostgreSQL et Redis se connectent correctement, puis cliquez sur « Enregistrer et continuer ».
Créer l’administrateur
Renseignez l’adresse e-mail, le nom d’utilisateur, le mot de passe et sa confirmation, puis cliquez sur « Terminer l’installation ».
Cela crée le premier administrateur système et vous connecte automatiquement. Cliquez sur « Commencer » pour accéder à l’application.
Après l’installation, vérifiez que vous pouvez créer des projets, modifier des enregistrements et téléverser des pièces jointes, et que votre déploiement conserve la configuration et les fichiers téléversés. Les paramètres du site, l’ouverture des inscriptions, les méthodes de connexion et les modèles d’IA se règlent dans la console d’administration.
Fournir la configuration à l’avance
Si un outil de gestion de configuration fournit les paramètres de connexion, vous pouvez préparer sayrud.yaml à l’avance. La configuration ci-dessous utilise le stockage local ; remplacez d’abord le mot de passe de connexion et auth.secret_key :
postgres:
dsn: "postgres://sayrud:[email protected]:5432/sayrud?sslmode=disable"
redis:
address: "127.0.0.1:6379"
username: ""
password: ""
auth:
secret_key: "REPLACE_WITH_BASE64_KEY"
storage:
type: local
local:
path: ./data/storageGénérez auth.secret_key avec cette commande et placez sa sortie complète dans la configuration :
openssl rand -base64 32Si vous rédigez une URL PostgreSQL manuellement, encodez les caractères spéciaux du mot de passe, tels que @, : et /, au format URL. L’assistant s’en charge si vous y saisissez les informations.
Placez le fichier à l’emplacement indiqué par les arguments de démarrage. Les autres options figurent dans l’exemple de configuration. Redémarrez le programme après une modification.
Dépannage
La page d’installation ne s’affiche pas
Si les journaux indiquent un démarrage réussi et que la base contient déjà des utilisateurs, le programme affiche directement l’application. Connectez-vous avec un compte existant.
Le jeton d’installation n’est plus valide
Vérifiez si le processus a redémarré pendant l’installation. Si SAYRUD_SETUP_TOKEN n’est pas défini, utilisez le jeton des journaux les plus récents. Sur K8s, vérifiez que le Pod utilise le Secret attendu et conservez une seule réplique lors de la première installation. Les échecs répétés déclenchent une limitation du nombre de tentatives ; vérifiez le jeton avant de réessayer.
Le test de connexion à la base échoue
Vérifiez que la base existe, que les identifiants sont corrects et que l’hôte ou le Pod de l’application peut joindre son adresse. Dans un conteneur, 127.0.0.1 désigne le conteneur lui-même. Si la connexion fonctionne mais que l’enregistrement échoue, vérifiez aussi les droits de migration du schéma.
L’assistant d’une nouvelle installation refuse d’utiliser une base contenant déjà des utilisateurs. Pour restaurer une instance, récupérez sa configuration, sa clé et ses fichiers d’origine, puis reconnectez-la à la base par le démarrage normal, sans reprendre l’étape de configuration de la base.
Erreur de permissions lors de l’enregistrement de la configuration
L’assistant écrit un fichier temporaire dans le répertoire de configuration avant de le valider comme sayrud.yaml ; ce répertoire doit donc être accessible en écriture. Vérifiez les montages en lecture seule, les ConfigMaps, les Secrets et les différences entre l’UID/GID du processus et le propriétaire du volume. Les images Docker et K8s utilisent 10001:10001.
La configuration est enregistrée, mais un redémarrage est demandé
Consultez les journaux, corrigez l’échec d’initialisation survenu ensuite et redémarrez avec le même chemin de configuration. Le fichier enregistré sera relu ; il n’est pas nécessaire de le supprimer et de réinstaller.
La page d’installation revient après la recréation du conteneur
Vérifiez que le répertoire de configuration est monté sur /home/app/config, que vous utilisez toujours la base PostgreSQL d’origine et que le nom du projet Compose ou le PVC K8s n’a pas changé. Récupérez la configuration et les données d’origine avant de relancer une installation.