Passer au contenu

Documents · Démarrage rapide

Une commande pour une connexion utilisable

Le contrat permanent du référentiel : docker compose sur un nouveau clone atteint une connexion utilisable sans configuration. Tout ce qui suit est détaillé autour de cette commande.

Avant de commencer

  • Docker Engine avec le plug-in Compose. Docker Desktop convient également. La pile est construite localement au premier lancement ; prévoyez environ 8 Go de RAM disponible.
  • Facultatif : une clé API Mistral pour les fonctions de modèle. Sans clé, la connexion, l'ingestion, le tableau de bord et la file d'attente restent opérationnels ; les appels au modèle renvoient une erreur typée explicite.
  • Node.js 22 et npm sont nécessaires uniquement pour le développement, pas pour exécuter la pile.
  1. 1

    Cloner et démarrer

    La première exécution crée les images et initialise l'identité, ce qui prend une minute ou deux.

    git clone https://github.com/Cogeto/cogeto.git
cd cogeto
docker compose up
  2. 2

    Ouvrez-le et connectez-vous

    Le dev edge sert un certificat auto-signé par une autorité de certification locale, de sorte que votre navigateur vous avertira une fois. Acceptez-le.

    Ouvrez https://localhost et connectez-vous comme administrateur d'amorçage de développement : admin@cogeto.localhost, avec le mot de passe DevPassword1! Vous consultez votre propre instance.

  3. 3

    Ajouter une clé de modèle

    Copiez .env.example dans .env, définissez votre clé et relancez la pile. Les valeurs par défaut du développement sont sécurisées pour localhost uniquement ; un conteneur de contrôle en amont refuse les secrets de développement connus sur tout domaine non localhost.

    cp .env.example .env
docker compose up -d

Le bac à sable Ana

Un consultant fictif avec des semaines de mémoire accumulée, semé via la véritable API publique : contradictions à résoudre, faits périmés, reçu de suppression signé. Le mot de passe d'accès est imprimé par la tâche d'amorçage. N'exécutez jamais le profil de démonstration sur une instance contenant des données réelles.

COGETO_DEMO_MODE=1 docker compose --profile demo up --build
docker compose logs demo-seed

Si quelque chose ne va pas

Le port 80 ou 443 est déjà pris

Un autre serveur web utilise déjà ce port. Arrêtez-le ou remplacez les ports publiés dans une surcharge Compose.

Le chat ou l'extraction renvoie une erreur de passerelle de modèle

Aucune clé API de modèle n'est définie. C'est le comportement conçu sans clé, pas un crash.

Un conteneur d'initialisation unique indique qu'il est sorti (0)

C'est normal. Le contrôle préalable, l'initialisation de la base de données, les migrations, le stockage et l'identité s'exécutent une fois au démarrage, puis se terminent.

Recommencer

docker compose down -v supprime toutes les données, y compris la clé de signature de l'instance et les reçus. Très bien sur une boîte de développement ; jamais la réponse sur une instance réelle.

docker compose down -v supprime tout, y compris la clé de signature d'instance et la chaîne de reçus. Dans un cas réel, la réponse est toujours une restauration de sauvegarde répétée, jamais un effacement.

Où aller à partir d'ici

Lorsque l'évaluation vous convainc, la production est une voie différente et plus sûre : des images signées et un script d'opérateur.

Auto-hébergé, en productionExécuté localement, la référence complète

Vous préférez le voir d’abord sur vos documents ?

Le pilote lit un véritable ensemble de documents et se termine par le rapport de constats signé.

Lancer un piloteRetour à tous les chemins