Exploitation

Installer une application

Télécharger une application avec bench get-app, choisir la bonne branche et l'installer sur un site Dokos auto-hébergé.

Installer une application

L'écosystème Dokos compte plusieurs applications (appelées modules, plugins ou add-ons dans d'autres logiciels). Vous pouvez les installer sur votre site si elles sont compatibles avec votre version de Dokos et avec les applications déjà installées.

Cette page concerne une installation auto-hébergée. Sur Dokos Cloud, demandez l'installation d'une application au support.

La liste des applications et leur compatibilité sont sur la page Catalogue des applications. En cas de doute, posez la question sur le forum. Vous pouvez aussi ouvrir un ticket sur la page GitLab ou GitHub de l'application : il faut un compte sur cette plateforme.

Prérequis

Un bench Dokos installé (voir Installation).
Une sauvegarde récente du site.

Choisir la branche

Pour les applications maintenues par Dokos, la branche de production de la v5 est v5. C'est la branche recommandée pour la plupart des usages : elle est compatible avec les branches v5 de Dodock et de Dokos. Utilisez toujours la branche sur laquelle chaque application publie ses versions officielles.

Sans option --branch, bench get-app récupère la branche par défaut du dépôt. Pour les applications Dokos, c'est develop : la future version majeure, destinée aux développeurs.

Télécharger une application

Placez-vous dans le dossier du bench, puis lancez :

bench get-app --branch v5 https://gitlab.com/dokos/bookings.git

L'application est clonée dans apps/, ses dépendances Python et JavaScript sont installées et ses fichiers statiques sont construits. --skip-assets évite cette construction.

Installer l'application sur un site

Une application téléchargée n'est active sur aucun site. Installez-la sur chaque site concerné :

bench --site <mon-site> install-app bookings

Lancez ensuite bench --site <mon-site> migrate, puis redémarrez les services (bench restart en production).

Commandes pour les applications Dokos

Application	Commande
Dokos	`bench get-app --branch v5 https://gitlab.com/dokos/dokos.git`
Payments	`bench get-app --branch v5 https://gitlab.com/dokos/payments.git`
Webshop	`bench get-app --branch v5 https://gitlab.com/dokos/webshop.git`
HRMS	`bench get-app --branch v5 https://gitlab.com/dokos/hrms.git`
Bookings	`bench get-app --branch v5 https://gitlab.com/dokos/bookings.git`
Construction	`bench get-app --branch v5 https://gitlab.com/dokos/construction.git`
WooCommerce	`bench get-app --branch v5 https://gitlab.com/dokos/dokos-woocommerce.git`
Hiboutik	`bench get-app --branch v5 https://gitlab.com/dokos/hiboutik.git`
eTransactions	`bench get-app --branch v5 https://gitlab.com/dokos/etransactions.git`

L'application OCR n'a pas de branche v5. En v5, eTransactions reprend la lecture des factures PDF.

Commandes pour les applications de l'écosystème Frappe

Ces applications suivent les branches de Frappe Technologies. Vérifiez leur compatibilité avec Dodock avant de les installer.

Application	Commande
Insights	`bench get-app --branch version-3 https://github.com/frappe/insights.git`
CRM	`bench get-app --branch main https://github.com/frappe/crm.git`
Helpdesk	`bench get-app --branch main https://github.com/frappe/helpdesk.git`
LMS	`bench get-app --branch main https://github.com/frappe/lms.git`
Builder	`bench get-app --branch master https://github.com/frappe/builder.git`
Raven	`bench get-app --branch main https://github.com/The-Commit-Company/raven.git`