Docker

Installer Crater avec Docker Compose en 2 minutes

Matthieu CALASIN

2 mai 2023 • 3 min read

Vous êtes à la recherche de l'outil parfait pour votre facturation, votre gestion de stock ainsi que la gestion globale de votre entreprise ou de votre auto entreprise si vous êtes en freelance ? Crater est fait pour vous ! En plus d'être un outil Open Source et gratuit, il s'installe très facilement.
C'est ce que nous allons aborder dans cet article.

Présentation

Crater est un logiciel codé en PHP, utilisant le framework Laravel pour la partie backend et intègre du code Javascript avec le framework Vue.js pour la partie front-end.

Crater dispose d'une interface web graphique très épurée :

Et dispose également d'une application mobile disponible sur Android et iOS :

Prérequis

Afin d'opter pour un déploiement simple et fiable, nous allons utiliser Docker Compose. il vous faudra donc disposer de :

Docker Engine et Docker Compose
Git

Installation

Comme dit plus haut, le logiciel Crater est Open Source. Voici le lien du repository Github :

Commençons par cloner le repository Github avec la commande suivante :

git clone https://github.com/crater-invoice/crater

Puis déplaçons-nous dans son répertoire :

cd crater

Il faut ensuite le copier le fichier .env contenant les variables d'environnement comme ceci :

cp .env.example .env

Avant de passer à l'étape suivante, éditez le fichier .env en entrant les valeurs adaptées à votre configuration avec notamment la variable APP_URL=http://crater.test à adapter à votre URL.

Maintenant que votre fichier .env contenant vos variables d'environnement est bien configuré, vous pouvez passer à l'étape du déploiement en exécutant la commande suivante :

docker-compose up -d

💡

Cette commande va procéder au build de l'image crater comme aucune version officielle n'est disponible sur le Docker Hub ou sur une autre registry. Il est donc normal que le build prenne quelques minutes dû à l'installation des nombreuses dépendances contenues dans l'image Docker.

Maintenant que les conteneurs ont été déployés à l'aide de Docker Compose, il faut exécuter le script suivant qui va installer les dépendances via l'outil Composer et générer une clé unique pour l'application :

./docker-compose/setup.sh

Finalisation

Accédez maintenant à l'URL que vous avez entré comme valeur la variable APP_URL, sur votre navigateur.
Un assistant d'installation va vous accompagner pour la finalisation de l'installation de Crater.
Vous aurez besoin des identifiants suivants, voici leurs valeurs par défaut :

Database Host : db
Database Name : crater
Database Username : crater
Database Password : crater

Après avoir suivi les instructions de l'assistant, vous avez terminé l'installation de Crater !