Installer Crater avec Docker Compose en 2 minutes
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
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 !